Rövid útmutató: .NET-alkalmazás létrehozása alkalmazáskonfigurációval
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álhatjaProgram.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.
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.