Quickstart: Een .NET Framework-app maken met Azure-app-configuratie

Er zijn twee manieren om Azure-app Configuration op te nemen in een .NET Framework-app.

• Met de configuratiebouwer voor App Configuration kunnen gegevens van App Configuration worden geladen in app-instellingen. Uw app heeft toegang tot de configuratie, zoals altijd via ConfigurationManager. U hoeft geen andere codewijziging aan te brengen dan updates voor app.config - of web.config-bestanden . Deze quickstart leidt u door deze optie.
• Zoals is ontworpen door .NET Framework, kunnen de app-instellingen alleen worden vernieuwd wanneer de toepassing opnieuw wordt opgestart. De .NET-provider van App Configuration is een .NET Standard-bibliotheek. Het biedt ondersteuning voor het dynamisch opslaan en vernieuwen van de configuratie zonder dat de toepassing opnieuw hoeft te worden opgestart. Als de dynamische configuratie essentieel is voor u en u bereid bent om codewijzigingen aan te brengen, raadpleegt u zelfstudies over het implementeren van dynamische configuratie-updates in een .NET Framework-console-app of een ASP.NET-web-app.

In deze quickstart wordt een .NET Framework-console-app gebruikt als voorbeeld, maar dezelfde techniek is van toepassing op een ASP.NET Web Forms/MVC-app.

Vereisten

• Een Azure-account met een actief abonnement. Maak gratis een account.
• Een App Configuration-winkel, zoals uiteengezet in de zelfstudie voor het maken van een winkel.
• Visual Studio
• .NET Framework 4.7.2 of hoger

Een sleutelwaarde toevoegen

Voeg de volgende sleutelwaarde toe aan het App Configuration-archief en laat label en inhoudstype ongewijzigd met de standaardwaarden. Ga voor meer informatie over hoe u sleutel-waarden aan een store kunt toevoegen met behulp van de Azure-portal of de CLI naar Een sleutel-waarde maken.

Een .NET Framework-console-app maken

1. Start Visual Studio en selecteer Een nieuw project maken.

2. Filter in Een nieuw project maken op het projecttype Console en selecteer Console-app (.NET Framework) met C# in de lijst met projectsjablonen. Druk op Volgende.

3. Voer in Uw nieuwe project configureren een projectnaam in. Selecteer onder Framework .NET Framework 4.7.2 of hoger. Druk op Aanmaken.

Verbinding maken met een App Configuration-store

Maak verbinding met uw App Configuration-store via Microsoft Entra ID (aanbevolen), of met een verbindingsreeks.

1. Klik met de rechtermuisknop op het project en selecteer NuGet-pakketten beheren. Zoek en voeg op het tabblad Bladeren de nieuwste stabiele versies van de volgende NuGet-pakketten toe aan uw project.

   • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
   • Microsoft.Configuration.ConfigurationBuilders.Environment
   • System.Configuration.ConfigurationManager

2. Werk het App.config-bestand van uw project als volgt bij. U kunt verbinding maken met uw App Configuration-opslag via Microsoft Entra ID (aanbevolen) of via een verbindingsreeks.

   • Microsoft Entra-id (aanbevolen)
   • Verbindingsreeks

   De DefaultAzureCredential wordt standaard gebruikt om u te verifiëren bij uw App Configuration-opslag. Volg de instructies om aan uw referentiegegeven de App Configuration Data Reader-rol toe te wijzen. Zorg ervoor dat u voldoende tijd hebt om de machtiging door te geven voordat u de toepassing uitvoert.

   <configSections>
       <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
   </configSections>
   
   <configBuilders>
       <builders>
           <add name="MyConfigStore" mode="Greedy" endpoint="${Endpoint}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
           <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
       </builders>
   </configBuilders>
   
   <appSettings configBuilders="Environment,MyConfigStore">
       <add key="AppName" value="Console App Demo" />
       <add key="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
   </appSettings>
   

   De waarde van het eindpunt van uw App Configuration-opslag wordt gelezen uit de omgevingsvariabele Endpoint. U voegt ook de Environment configuratiebouwer toe vóór de MyConfigStore in de configBuilders-eigenschap van de appSettings-sectie.

3. Open Program.cs en werk de methode Main bij voor het gebruik van App Configuration door de methode ConfigurationManager aan te roepen.

   static void Main(string[] args)
   {
       string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];
   
       Console.WriteLine(message);
       Console.ReadKey();
   }
   

Ontwikkel de app en voer deze uit

1. Stel een omgevingsvariabele in.

   • Microsoft Entra-id (aanbevolen)
   • Verbindingsreeks

   Stel een omgevingsvariabele met de naam Endpoint in op het eindpunt van uw App Configuration-opslag, te vinden onder Overzicht van uw opslag in de Azure-portal.

   Als u de Windows-opdrachtprompt gebruikt, voert u de volgende opdracht uit en start u de opdrachtprompt opnieuw om de wijziging door te voeren:

   setx Endpoint "<AppConfigurationEndpoint>"
   

   Als u PowerShell gebruikt, voert u de volgende opdracht uit:

   $Env:Endpoint = "<AppConfigurationEndpoint>"
   

   Als u macOS of Linux gebruikt, voert u de volgende opdracht uit:

   export Endpoint='<AppConfigurationEndpoint>'
   

2. Start Visual Studio opnieuw zodat de wijziging kan worden doorgevoerd.

3. Druk op Ctrl+F5 om de console-app te bouwen en te starten. Je ziet het bericht van App-configuratie in de console.

Hulpbronnen opschonen

Als u de resources die in dit artikel zijn gemaakt niet wilt blijven gebruiken, verwijdert u de resourcegroep die u hier hebt gemaakt om kosten te voorkomen.

1. Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
2. Voer de naam van de resourcegroep in het vak Filteren op naam in.
3. Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
4. Selecteer Resourcegroep verwijderen.
5. U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Voer de naam van de resourcegroep in ter bevestiging en selecteer Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

Volgende stappen

In deze quickstart hebt u een nieuwe App Configuration-opslag gemaakt en deze gebruikt met een .NET Framework-consoletoepassing. Als u wilt weten hoe u uw .NET Framework-app kunt inschakelen om configuratie-instellingen dynamisch te vernieuwen, gaat u verder met de volgende zelfstudies.