Quickstart: Een .NET Core-app maken met App Configuration

In deze quickstart neemt u Azure App Configuration op in een .NET Core-console-app om opslag en beheer van toepassingsinstellingen gescheiden van uw code te centraliseren.

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• .NET Core SDK: ook beschikbaar in de Azure Cloud Shell.

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 > Maken > Sleutelwaarde om de volgende sleutel-waardeparen toe te voegen:

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

   Laat Label en Inhoudstype nog even leeg.

8. Selecteer Toepassen.

Een .NET Core-console-app maken

U gebruikt de opdrachtregelinterface (CLI) van .NET Core om een nieuw web-app-project van .NET Core Console te maken. Het voordeel van de CLI van .NET Core ten opzichte van Visual Studio is dat de interface beschikbaar is voor Windows, macOS en Linux. U kunt ook de vooraf geïnstalleerde hulpprogramma's gebruiken die beschikbaar zijn in de Azure Cloud Shell.

1. Maak een nieuwe map voor uw project.

2. Voer in de nieuwe map de volgende opdracht uit om een nieuw console-app-project van NET Core te maken:

   dotnet new console
   

Verbinding maken met een App Configuration-archief

1. Voeg een verwijzing toe naar het NuGet-pakket Microsoft.Extensions.Configuration.AzureAppConfiguration door de volgende opdracht uit te voeren:

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Voer de volgende opdracht uit om pakketten voor uw project te herstellen:

   dotnet restore
   

3. Open Program.cs en voeg een verwijzing toe naar de configuratieprovider van .NET Core App Configuration.

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   

4. Werk de methode Main bij voor het gebruik van App Configuration door de methode builder.AddAzureAppConfiguration() aan te roepen.

   static void Main(string[] args)
   {
       var builder = new ConfigurationBuilder();
       builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
   
       var config = builder.Build();
       Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   }
   

De app lokaal compileren en uitvoeren

1. Stel een omgevingsvariabele met de naam ConnectionString in en stel deze in op de toegangssleutel van het App Configuration-archief. Voer op de opdrachtregel de volgende opdracht uit:

   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"
   

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

   export ConnectionString='connection-string-of-your-app-configuration-store'
   

   Start de opdrachtprompt opnieuw op om de wijziging door te voeren. Druk de waarde van de omgevingsvariabele af om te controleren of deze juist is ingesteld.

2. Voer de volgende opdracht uit om de console-app te bouwen:

   dotnet build
   

3. Nadat het bouwen is voltooid, voert u de volgende opdracht uit om de app lokaal uit te voeren:

   dotnet run
   

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 via de App Configuration-provider gebruikt met een .NET Core-console-app. Ga door naar de volgende zelfstudie voor meer informatie over het configureren van uw .NET Core-app om configuratie-instellingen dynamisch te vernieuwen.