Quickstart: Een .NET-app maken met App Configuration

Artikel
02/21/2024

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

Vereisten

Een Azure-account met een actief abonnement. Maak gratis een account.
Een App Configuration-archief. Een winkel maken.
.NET SDK 6.0 of hoger , ook beschikbaar in Azure Cloud Shell.

Een sleutelwaarde toevoegen

Voeg de volgende sleutelwaarde toe aan het App Configuration-archief en laat label en inhoudstype ongewijzigd met de standaardwaarden. Ga naar Een sleutelwaarde maken voor meer informatie over het toevoegen van sleutelwaarden aan een archief met behulp van Azure Portal of de CLI.

Sleutel	Weergegeven als
TestApp:Instellingen:Message	Gegevens uit Azure-app-configuratie

Een .NET Core-consoletoepassing maken

U kunt de .NET-opdrachtregelinterface (CLI) gebruiken om een nieuw .NET-console-app-project te maken. Het voordeel van het gebruik van de .NET CLI via Visual Studio is dat deze beschikbaar is op de Windows-, macOS- en Linux-platformen. U kunt ook de vooraf geïnstalleerde hulpprogramma's gebruiken die beschikbaar zijn in de Azure Cloud Shell.

Maak een nieuwe map voor uw project.
Voer in de nieuwe map de volgende opdracht uit om een nieuw .NET-console-app-project te maken:
```
dotnet new console
```

Verbinding maken met een App Configuration-archief

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
```
Voer de volgende opdracht uit om pakketten voor uw project te herstellen:
```
dotnet restore
```

Open Program.cs en voeg de volgende instructies toe:

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

Gebruik App Configuration door de AddAzureAppConfiguration methode in het Program.cs bestand aan te roepen.

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

De app lokaal bouwen en uitvoeren

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:
Voer de volgende opdracht uit om de app lokaal te bouwen en uit te voeren met behulp van de Windows-opdrachtprompt:
```
setx 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.
Als u Windows PowerShell gebruikt, voert u de volgende opdracht uit:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Als u macOS gebruikt, voert u de volgende opdracht uit:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Als u Linux gebruikt, voert u de volgende opdracht uit:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Voer de volgende opdracht uit om de console-app te bouwen:
```
dotnet build
```
Nadat het bouwen is voltooid, voert u de volgende opdracht uit om de app lokaal uit te voeren:
```
dotnet run
```

Resources 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.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle resources daarin worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert. Als u de resources voor dit artikel in een resourcegroep hebt gemaakt die andere resources bevat die u wilt behouden, moet u elke resource afzonderlijk verwijderen uit het deelvenster in plaats van dat u de resourcegroep verwijdert.

Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
Voer de naam van de resourcegroep in het vak Filteren op naam in.
Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
Selecteer Resourcegroep verwijderen.
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 gebruikt met een .NET-console-app via de App Configuration-provider. Als u wilt weten hoe u uw .NET-app configureert om configuratie-instellingen dynamisch te vernieuwen, gaat u verder met de volgende zelfstudie.

Dynamische configuratie inschakelen