Snabbstart: Skapa en .NET-app med App Configuration

Artikel
04/04/2024

I den här snabbstarten införlivar du Azure App Configuration i en .NET-konsolapp för att centralisera lagring och hantering av programinställningar separat från din kod.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa en kostnadsfritt.
Ett appkonfigurationsarkiv. Skapa en butik.
.NET SDK 6.0 eller senare – även tillgängligt i Azure Cloud Shell.

Lägga till ett nyckelvärde

Lägg till följande nyckelvärde i appkonfigurationsarkivet och lämna Etikett och innehållstyp med sina standardvärden. Mer information om hur du lägger till nyckelvärden i ett arkiv med hjälp av Azure-portalen eller CLI finns i Skapa ett nyckelvärde.

Tangent	Värde
TestApp:Inställningar:Message	Data från Azure App Configuration

Skapa en .NET-konsolapp

Du kan använda .NET-kommandoradsgränssnittet (CLI) för att skapa ett nytt .NET-konsolappprojekt. Fördelen med att använda .NET CLI över Visual Studio är att det är tillgängligt på Windows-, macOS- och Linux-plattformarna. Du kan också använda de förinstallerade verktygen som är tillgängliga i Azure Cloud Shell.

Skapa en ny mapp för ditt projekt.
I den nya mappen kör du följande kommando för att skapa ett nytt .NET-konsolappprojekt:
```
dotnet new console
```

Anslut till ett appkonfigurationsarkiv

Lägg till en referens till Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet-paketet genom att köra följande kommando:
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
Kör följande kommando för att återställa paket för projektet:
```
dotnet restore
```

Öppna Program.cs och lägg till följande instruktioner:

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

Använd App Configuration genom att anropa AddAzureAppConfiguration metoden i Program.cs filen.

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

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

Skapa och köra appen lokalt

Ange en miljövariabel med namnet Anslut ionString och ställ in den på åtkomstnyckeln till appkonfigurationsarkivet. Kör följande kommando på kommandoraden:
Kör följande kommando för att skapa och köra appen lokalt med hjälp av Windows-kommandotolken:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Starta om kommandotolken så att ändringen börjar gälla. Skriv ut värdet för miljövariabeln för att verifiera att den har angetts korrekt.
Om du använder Windows PowerShell kör du följande kommando:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Om du använder macOS kör du följande kommando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Om du använder Linux kör du följande kommando:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Kör följande kommando för att skapa konsolappen:
```
dotnet build
```
När bygget har slutförts kör du följande kommando för att köra appen lokalt:
```
dotnet run
```

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapas i den här artikeln tar du bort resursgruppen som du skapade här för att undvika avgifter.

Viktigt!

Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser i den tas bort permanent. Se till att du inte oavsiktligt tar bort fel resursgrupp eller resurser. Om du har skapat resurserna för den här artikeln i en resursgrupp som innehåller andra resurser som du vill behålla tar du bort varje resurs individuellt från respektive fönster i stället för att ta bort resursgruppen.

Logga in på Azure-portalen och välj Resursgrupper.
I rutan Filtrera efter namn anger du namnet på resursgruppen.
I resultatlistan väljer du resursgruppens namn för att se en översikt.
Välj Ta bort resursgrupp.
Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resursgruppen för att bekräfta och välj Ta bort.

Efter en liten stund tas resursgruppen och alla dess resurser bort.

Nästa steg

I den här snabbstarten skapade du ett nytt appkonfigurationsarkiv och använde det med en .NET-konsolapp via appkonfigurationsprovidern. Om du vill lära dig hur du konfigurerar .NET-appen för att dynamiskt uppdatera konfigurationsinställningarna fortsätter du till nästa självstudie.

Aktivera dynamisk konfiguration