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

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

1. Indítsa el a Visual Studiót, és válassza az Új projekt létrehozása lehetőséget.

2. Ú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.

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

1. 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ó

2. 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 MyConfigStore configBuilders szakasz tulajdonsága appSettings elé.

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

1. Á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"
   

2. Indítsa újra a Visual Studiót a módosítás érvénybe lépésének engedélyezéséhez.

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

1. Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
2. A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
3. Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
4. Válassza az Erőforráscsoport törlése elemet.
5. 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