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

Cikk
02/21/2024

A Azure-alkalmazás Konfigurációt kétféleképpen lehet beépíteni egy .NET-keretrendszer-alapú alkalmazásba.

Az Alkalmazáskonfiguráció konfigurációszerkesztője lehetővé teszi az alkalmazáskonfigurációból származó adatok betöltését az Alkalmazás Gépház. Az alkalmazás ugyanúgy fér hozzá a konfigurációhoz, mint mindig.ConfigurationManager Az app.config vagy a web.config fájlok frissítésen kívül más kódot nem kell módosítania. Ez a rövid útmutató végigvezeti ezen a beállításon.
A .NET-keretrendszer által tervezett módon az alkalmazás Gépház csak az alkalmazás újraindítása után frissíthet. Az alkalmazáskonfiguráció .NET-szolgáltatója egy .NET Standard kódtár. Támogatja a konfiguráció dinamikus gyorsítótárazását és frissítését az alkalmazás újraindítása nélkül. Ha a dinamikus konfiguráció elengedhetetlen Az Ön számára, és ön hajlandó módosítani a kódokat, tekintse meg a dinamikus konfigurációs frissítések .NET-keretrendszer konzolalkalmazásokban vagy ASP.NET webalkalmazásokban való implementálásával kapcsolatos oktatóanyagokat.

Ebben a rövid útmutatóban egy .NET-keretrendszer konzolalkalmazást használunk példaként, de ugyanez a módszer egy ASP.NET Web Forms/MVC alkalmazásra is vonatkozik.

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.
Visual Studio
.NET-keretrendszer 4.7.2 vagy újabb verzió

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-keretrendszer konzolalkalmazás létrehozása

Indítsa el a Visual Studiót, és válassza az Új projekt létrehozása lehetőséget.
Új projekt létrehozása esetén szűrjön a konzolprojekt típusára, és válassza a Konzolalkalmazás (.NET-keretrendszer) lehetőséget a C#-tal a projektsablonok listájából. Nyomja le a Tovább gombot.
Az új projekt konfigurálásához adjon meg egy projektnevet. A Keretrendszer területen válassza a .NET-keretrendszer 4.7.2 vagy újabb verziót. Kattintson a Létrehozás gombra.

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

Kattintson a jobb gombbal a projektre, és válassza a NuGet-csomagok kezelése lehetőséget. A Tallózás lapon keresse meg és adja hozzá a következő NuGet-csomagokat a projekthez.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration 1.0.0-s vagy újabb verzió
- Microsoft.Configuration.ConfigurationBuilders.Environment 2.0.0-s vagy újabb verzió
- System.Configuration.ConfigurationManager 4.6.0-s vagy újabb verzió

Frissítse a projekt App.config fájlját az alábbiak szerint:

<configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" connectionString="${ConnectionString}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

Az Alkalmazáskonfigurációs áruház kapcsolati sztring a környezeti változóból ConnectionStringolvassa be. Adja hozzá a Environment konfigurációszerkesztőt a MyConfigStoreconfigBuilders szakasz tulajdonsága appSettings elé.

Nyissa meg a Program.cs, és hívja meg a metódust ConfigurationManageraz Main alkalmazáskonfiguráció használatára.

static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

Készítsen buildet és futtassa az alkalmazást

Állítson be egy Csatlakozás ionString nevű környezeti változót az Alkalmazáskonfigurációs áruház létrehozása során beszerzett írásvédett kulcsra kapcsolati sztring.

Ha a Windows parancssorát használja, futtassa a következő parancsot:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Windows PowerShell használata esetén futtassa a következő parancsot:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Indítsa újra a Visual Studiót a módosítás érvénybe lépésének engedélyezéséhez.
A konzolalkalmazás létrehozásához és futtatásához nyomja le a Ctrl + F5 billentyűkombinációt. A konzol alkalmazáskonfigurációs kimeneteiből származó üzenetnek kell megjelennie.

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-keretrendszer konzolalkalmazással használt. Ha szeretné megtudni, hogyan engedélyezheti .NET-keretrendszer alkalmazásának a konfigurációs beállítások dinamikus frissítését, folytassa a következő oktatóanyagokkal.

Dinamikus konfiguráció engedélyezése .NET-keretrendszer-alkalmazásokban

Dinamikus konfiguráció engedélyezése egy ASP.NET-webalkalmazásban