add .NET example

Author: zhiyuanliang-ms

articles/azure-app-configuration/TOC.yml

@@ -33,7 +33,7 @@
       items:
         - name: ASP.NET Core
           href: quickstart-feature-flag-aspnet-core.md
-        - name: .NET Framework
+        - name: .NET/.NET Framework
           href: quickstart-feature-flag-dotnet.md
         - name: Java Spring
           href: quickstart-feature-flag-spring-boot.md

articles/azure-app-configuration/media/quickstarts/dotnet-app-feature-flag-disabled.png

@@ -1,29 +1,37 @@
 ---
-title: Quickstart for adding feature flags to .NET Framework apps | Microsoft Docs | Microsoft Docs
-description: A quickstart for adding feature flags to .NET Framework apps and managing them in Azure App Configuration
+title: Quickstart for adding feature flags to .NET apps
+titleSuffix: Azure App Configuration
+description: A quickstart for adding feature flags to .NET apps and managing them in Azure App Configuration.
 services: azure-app-configuration
 author: maud-lv
 ms.service: azure-app-configuration
 ms.devlang: csharp
 ms.custom: devx-track-csharp, mode-other, devx-track-dotnet
 ms.topic: quickstart
 ms.tgt_pltfrm: .NET
-ms.date: 3/20/2023
-ms.author: malev
-#Customer intent: As a .NET Framework developer, I want to use feature flags to control feature availability quickly and confidently.
+ms.date: 2/19/2024
+ms.author: zhiyuanliang
+#Customer intent: As a .NET developer, I want to use feature flags to control feature availability quickly and confidently.
 ---
-# Quickstart: Add feature flags to a .NET Framework console app
+# Quickstart: Add feature flags to a .NET/.NET Framework console app
 
-In this quickstart, you incorporate Azure App Configuration into a .NET Framework app to create an end-to-end implementation of feature management. You can use the App Configuration service to centrally store all your feature flags and control their states. 
+In this quickstart, you incorporate Azure App Configuration into a .NET console app to create an end-to-end implementation of feature management. You can use the App Configuration service to centrally store all your feature flags and control their states. 
 
 The .NET Feature Management libraries extend the framework with feature flag support. These libraries are built on top of the .NET configuration system. They integrate with App Configuration through its .NET configuration provider.
 
 ## Prerequisites
 
 - An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/).
 - An App Configuration store. [Create a store](./quickstart-azure-app-configuration-create.md#create-an-app-configuration-store).
-- [Visual Studio 2019](https://visualstudio.microsoft.com/vs)
-- [.NET Framework 4.8](https://dotnet.microsoft.com/download)
+
+### [.NET](#tab/dotnet)
+- [.NET SDK](https://dotnet.microsoft.com/download) - also available in the [Azure Cloud Shell](https://shell.azure.com).
+
+### [.NET Framework](#tab/dotnet-framework)
+- [.NET Framework 4.7.2 or later](https://dotnet.microsoft.com/download/dotnet-framework)
+- [Visual Studio](https://visualstudio.microsoft.com/vs)
+
+---
 
 ## Add a feature flag
 
@@ -32,15 +40,80 @@ Add a feature flag called *Beta* to the App Configuration store and leave **Labe
 > [!div class="mx-imgBorder"]
 > ![Enable feature flag named Beta](media/add-beta-feature-flag.png)
 
-## Create a .NET Framework console app
+## Create a .NET console app
+
+### [.NET](#tab/dotnet)
+
+You use the [.NET command-line interface (CLI)](/dotnet/core/tools/) to create a new .NET console app project. The advantage of using the .NET CLI over Visual Studio is that it's available across the Windows, macOS, and Linux platforms.  Alternatively, use the preinstalled tools available in the [Azure Cloud Shell](https://shell.azure.com).
+
+1. Create a new folder for your project.
+
+1. In the new folder, run the following command to create a new .NET console app project:
+
+    ```dotnetcli
+    dotnet new console
+    ```
+
+### [.NET Framework](#tab/dotnet-framework)
 
 1. Start Visual Studio, and select **File** > **New** > **Project**.
 
 1. In **Create a new project**, filter on the **Console** project type and click on **Console App (.NET Framework)**. Click **Next**.
 
 1. In **Configure your new project**, enter a project name. Under **Framework**, select **.NET Framework 4.8** or higher. Click **Create**.
 
-## Connect to an App Configuration store
+---
+
+## Use feature flag
+
+### [.NET](#tab/dotnet)
+
+1. Add references to the `Microsoft.Extensions.Configuration.AzureAppConfiguration` and `Microsoft.FeatureManagement` NuGet packages by running the following commands.
+
+    ```dotnetcli
+    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
+    dotnet add package Microsoft.FeatureManagement
+    ```
+
+1. Run the following command to restore packages for your project.
+
+    ```dotnetcli
+    dotnet restore
+    ```
+
+1. Open *Program.cs* and add the following statements.
+
+    ```csharp
+    using Microsoft.Extensions.Configuration;
+    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
+    using Microsoft.FeatureManagement;
+    ```
+
+1. Connect to App Configuration, specifying the `UseFeatureFlags` option so that feature flags are retrieved. Create a `ConfigurationFeatureDefinitionProvider` to provide feature flag definition from the configuration and a `FeatureManager` to evaluate feature flags' state. Then display a message if the `Beta` feature flag is enabled.
+
+    ```csharp
+        IConfiguration configuration = new ConfigurationBuilder()
+            .AddAzureAppConfiguration(options =>
+            {
+                options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
+                    .UseFeatureFlags();
+            }).Build();
+
+        IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);
+
+        IFeatureManager featureManager = new FeatureManager(
+            featureDefinitionProvider, 
+            new FeatureManagementOptions());
+
+        if (await featureManager.IsEnabledAsync("Beta"))
+        {
+            Console.WriteLine("Welcome to the beta!");
+        }
+
+        Console.WriteLine("Hello World!");
+    ```
+
+### [.NET Framework](#tab/dotnet-framework)
 
 1. Right-click your project, and select **Manage NuGet Packages**. On the **Browse** tab, search and add the following NuGet packages to your project.
 
@@ -49,7 +122,7 @@ Add a feature flag called *Beta* to the App Configuration store and leave **Labe
     Microsoft.FeatureManagement
     ```
 
-1. Open *Program.cs* and add the following statements:
+1. Open *Program.cs* and add the following statements.
 
     ```csharp
     using Microsoft.Extensions.Configuration;
@@ -82,28 +155,88 @@ Add a feature flag called *Beta* to the App Configuration store and leave **Labe
             }
 
             Console.WriteLine("Hello World!");
-            Console.WriteLine("Press any key to continue ...");
-            Console.Read();
         }
     ```
 
+---
+
 ## Build and run the app locally
 
-1. Set an environment variable named **ConnectionString** to the connection string of your App Configuration store. If you use the Windows command prompt, run the following command:
+1. Set an environment variable named **ConnectionString** to the connection string of your App Configuration store. If you use the Windows command prompt, run the following command.
+
+    ### [Windows command prompt](#tab/windowscommandprompt)
+
+    To build and run the app locally using the Windows command prompt, run the following command:
 
     ```console
-        setx ConnectionString "connection-string-of-your-app-configuration-store"
+    setx ConnectionString "connection-string-of-your-app-configuration-store"
+    ```
+
+    Restart the command prompt to allow the change to take effect. Print the value of the environment variable to validate that it's set properly.
+
+    ### [PowerShell](#tab/powershell)
+
+    If you use Windows PowerShell, run the following command.
+
+    ```azurepowershell
+    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
     ```
 
-    If you use Windows PowerShell, run the following command:
+    ### [macOS](#tab/unix)
 
-    ```powershell
-        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
+    If you use macOS, run the following command.
+
+    ```console
+    export ConnectionString='connection-string-of-your-app-configuration-store'
     ```
 
-1. Restart Visual Studio to allow the change to take effect. 
+    Restart the command prompt to allow the change to take effect. Print the value of the environment variable to validate that it's set properly.
+
+    ### [Linux](#tab/linux)
+
+    If you use Linux, run the following command.
+
+    ```console
+    export ConnectionString='connection-string-of-your-app-configuration-store'
+    ```
+
+    Restart the command prompt to allow the change to take effect. Print the value of the environment variable to validate that it's set properly.
+
+    ---
+
+1. Build and run the application.
+
+    ### [.NET](#tab/dotnet)
+
+    - Run the following command to build the console app.
+
+        ```dotnetcli
+        dotnet build
+        ```
+
+    - After the build successfully completes, run the following command to run the app locally.
+
+        ```dotnetcli
+        dotnet run
+        ```
+
+    ### [.NET Framework](#tab/dotnet-framework)    
+
+    - Restart Visual Studio to allow the change to take effect. 
+
+    - Press Ctrl + F5 to build and run the console app.
+
+    ---
+
+1. You should see the following outputs in the console.
+
+    ![App with feature flag disabled](./media/quickstarts/dotnet-app-feature-flag-disabled.png)
+
+1. Sign in to the [Azure portal](https://portal.azure.com). Select **All resources**, and select the App Configuration store that you created previously. 
+
+1. Select **Feature manager** and locate the **Beta** feature flag. Enable the flag by selecting the checkbox under **Enabled**.
 
-1. Press Ctrl + F5 to build and run the console app.
+1. Run the application again. You should see the Beta message in the console.
 
     ![App with feature flag enabled](./media/quickstarts/dotnet-app-feature-flag.png)