Rövid útmutató: .NET-alkalmazás létrehozása alkalmazáskonfigurációval

Cikk
04/04/2024

Ebben a rövid útmutatóban a Azure-alkalmazás Konfigurációt egy .NET-konzolalkalmazásba építi be, hogy a kódtól elkülönítve központosítsa az alkalmazásbeállítások tárolását és kezelését.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.
Alkalmazáskonfigurációs áruház. Hozzon létre egy áruházat.
.NET SDK 6.0 vagy újabb – az Azure Cloud Shellben is elérhető.

Kulcs-érték hozzáadása

Adja hozzá a következő kulcsértéket az Alkalmazáskonfigurációs áruházhoz, és hagyja meg a címke és a tartalomtípus alapértelmezett értékeit. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs	Érték
TestApp:Gépház:Message	Adatok Azure-alkalmazás konfigurációjából

.NET-konzolalkalmazás létrehozása

A .NET parancssori felülettel (CLI) létrehozhat egy új .NET-konzolalkalmazás-projektet. A .NET CLI Visual Studióval való használatának előnye, hogy windowsos, macOS és Linux platformokon is elérhető. Másik lehetőségként használja az Azure Cloud Shellben elérhető előre telepített eszközöket.

Hozzon létre egy új mappát a projekthez.
Az új mappában futtassa a következő parancsot egy új .NET-konzolalkalmazás-projekt létrehozásához:
```
dotnet new console
```

Csatlakozás alkalmazáskonfigurációs áruházba

Adjon hozzá egy hivatkozást a Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet-csomaghoz az alábbi parancs futtatásával:
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
Futtassa a következő parancsot a projekt csomagjainak visszaállításához:
```
dotnet restore
```

Nyissa meg a Program.cs, és adja hozzá a következő utasításokat:

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

Az alkalmazáskonfigurációt a fájl metódusának AddAzureAppConfiguration meghívásával használhatja Program.cs .

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

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

Az alkalmazás helyi létrehozása és futtatása

Állítson be egy Csatlakozás ionString nevű környezeti változót, és állítsa be az App Configuration Store hozzáférési kulcsára. Futtassa a következő parancsot a parancssorban:
Ha az alkalmazást helyileg szeretné létrehozni és futtatni a Windows parancssorával, futtassa a következő parancsot:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez. A környezeti változó értékének nyomtatásával ellenőrizheti, hogy megfelelően van-e beállítva.
Windows PowerShell használata esetén futtassa a következő parancsot:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
MacOS használata esetén futtassa a következő parancsot:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Linux használata esetén futtassa a következő parancsot:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Futtassa a következő parancsot a konzolalkalmazás létrehozásához:
```
dotnet build
```
A build sikeres befejezése után futtassa a következő parancsot az alkalmazás helyi futtatásához:
```
dotnet run
```

Az erőforrások eltávolítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
Válassza az Erőforráscsoport törlése elemet.
A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy új Alkalmazáskonfigurációs áruházat, amelyet egy .NET-konzolalkalmazással használt az alkalmazáskonfigurációs szolgáltatón keresztül. Ha szeretné megtudni, hogyan konfigurálhatja a .NET-alkalmazást a konfigurációs beállítások dinamikus frissítésére, folytassa a következő oktatóanyagban.

Dinamikus konfiguráció engedélyezése