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

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

• Met configuration builder voor App Configuration kunnen gegevens uit App Configuration worden geladen in App Instellingen. Uw app heeft toegang tot de configuratie zoals dit altijd gebeurt via ConfigurationManager . U hoeft geen andere code te wijzigen dan updates voorapp.config of web.configbestanden. In deze quickstart doorloop u deze optie.
• Zoals is ontworpen door de .NET Framework, kan de app-Instellingen alleen worden vernieuwd wanneer de toepassing opnieuw wordt gestart. De App Configuration .NET-provider is een .NET Standard-bibliotheek. Het biedt ondersteuning voor het dynamisch in de caching en vernieuwen van de configuratie zonder dat de toepassing opnieuw moet worden opgestart. Als de dynamische configuratie essentieel voor u is en u bereid bent codewijzigingen aan te brengen, bekijkt 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

• Azure-abonnement: u kunt een gratis abonnement nemen
• Visual Studio
• .NET Framework 4.7.2 of hoger

Een App Configuration-archief maken

1. Als u een nieuw App Configuration-archief wilt maken, moet u zich eerst aanmelden bij de Azure-portal. Selecteer in de linkerbovenhoek van de startpagina de optie Een resource maken. Voer in het vak Marketplace doorzoeken App Configuration in en selecteer Invoeren.

   

2. Selecteer App Configuration in de zoekresultaten en selecteer vervolgens Maken.

   

3. Voer in het deelvenster App Configuration maken de volgende instellingen in:

   Instelling	Voorgestelde waarde	Beschrijving
   Abonnement	Uw abonnement	Selecteer het Azure-abonnement dat u wilt gebruiken om App Configuration te testen. Als uw account maar één abonnement heeft, wordt dit automatisch geselecteerd en wordt de lijst Abonnement niet weergegeven.
   Resourcegroep	AppConfigTestResources	Selecteer of maak een resourcegroep voor de resource van het App Configuration-archief. Deze groep is handig voor het ordenen van meerdere resources die u mogelijk op een bepaald moment wilt verwijderen door resourcegroep te verwijderen. Zie Resourcegroepen gebruiken om Azure-resources te beheren voor meer informatie.
   Resourcenaam	Wereldwijd unieke naam	Voer een unieke resourcenaam in voor de resource van het App Configuration-archief. De naam moet een tekenreeks zijn van 5 tot 50 tekens en mag alleen cijfers, letters en - bevatten. De naam mag niet beginnen of eindigen met -.
   Locatie	US - centraal	Gebruik Locatie om de geografische locatie op te geven waar het app-configuratiearchief wordt gehost. Voor de beste prestaties maakt u de resource in dezelfde regio als de andere onderdelen van uw toepassing.
   Prijscategorie	Gratis	Selecteer de gewenste prijscategorie. Ga voor meer informatie naar de pagina met prijzen voor App Configuration.

4. Selecteer Beoordelen en maken om de instellingen te valideren.

5. Selecteer Maken. De implementatie kan enkele minuten duren.

6. Als de implementatie is voltooid, gaat u naar de resource App Configuration. Selecteer Instellingen > Toegangssleutels. Noteer de verbindingsreeks van de primaire alleen-lezensleutel. U hebt de verbindingsreeks later nodig voor de configuratie van uw toepassing, zodat deze kan communiceren met het App Configuration-archief dat u hebt gemaakt.

7. Selecteer Configuratieverkenner > + > Sleutelwaarde maken om de volgende sleutelwaarde toe te voegen:

   Sleutel	Waarde
   TestApp:Settings:Message	Gegevens van Azure App Configuration

   Laat Label en Inhoudstype leeg.

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. Kies Maken.

Verbinding maken met een App Configuration-archief

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

   • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration versie 1.0.0 of hoger
   • Microsoft.Configuration.ConfigurationBuilders.Environment versie 2.0.0 of hoger
   • System.Configuration.ConfigurationManager versie 4.6.0 of hoger

2. Werk het bestand App.config van uw project als volgt bij:

   <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" connectionString="${ConnectionString}" 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="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
   </appSettings>
   

   De verbindingstekenreeks van uw App Configuration-archief wordt gelezen vanuit de omgevingsvariabele ConnectionString. Voeg de Environment-configuratiebouwer toe vóór de MyConfigStore in de eigenschap configBuilders van de sectie appSettings.

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();
   }
   

De app bouwen en uitvoeren

1. Stel een omgevingsvariabele met de naam ConnectionString in op de alleen-connection string die u hebt verkregen tijdens het maken App Configuration winkel.

   Als u de Windows-opdrachtprompt gebruikt, moet u de volgende opdracht uitvoeren:

   setx ConnectionString "connection-string-of-your-app-configuration-store"
   

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

   $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

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

3. Druk op Ctrl + F5 om de consoletoepassing te bouwen en uit te voeren. Als het goed is, ziet u het App Configuration uitvoer in de console.

Resources opschonen

Als u niet door wilt gaan met de resources die in dit artikel zijn gemaakt, 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 nieuw App Configuration-archief gemaakt en dit gebruikt met een .NET Core console-app. Als u wilt weten hoe u uw .NET Framework-app in staat stelt om configuratie-instellingen dynamisch te vernieuwen, gaat u verder met de volgende zelfstudies.