rychlý start: vytvoření aplikace .NET Framework s využitím konfigurace aplikace Azure

existují dva způsoby, jak začlenit konfiguraci aplikace Azure do aplikace založené na .NET Framework.

• konfigurace nástroje configuration builder pro aplikace umožňuje načtení dat z konfigurace aplikace do aplikace Nastavení. Vaše aplikace přistupuje ke konfiguraci, protože to vždy provádí prostřednictvím ConfigurationManager . Nemusíte dělat žádné změny kódu jiné než aktualizace app.config nebo web.config souborů. Tento rychlý Start vás provede touto možností.
• jak je navrženo .NET Framework, Nastavení aplikace se dá aktualizovat jenom při restartu aplikace. Poskytovatel rozhraní .NET konfigurace aplikace je knihovna .NET Standard. Podporuje ukládání do mezipaměti a dynamické obnovení konfigurace bez restartování aplikace. pokud je dynamická konfigurace pro vás zásadní a vy jste ochotni dělat změny v kódu, přečtěte si téma kurzy, jak můžete implementovat aktualizace dynamické konfigurace v aplikaci .NET Framework konzolu nebo v ASP.NET webové aplikaci.

v tomto rychlém startu se jako příklad používá aplikace konzoly .NET Framework console, ale stejný postup se vztahuje i na aplikaci ASP.NET Web Forms/MVC.

Požadavky

• Předplatné Azure – Vytvořte si ho zdarma .
• Visual Studio
• .NET Framework 4.7.2 nebo novější

Vytvoření úložiště konfigurace aplikace

1. Pokud chcete vytvořit nové úložiště konfigurace aplikace, přihlaste se k Azure Portal. V levém horním rohu domovské stránky vyberte vytvořit prostředek. Do pole Hledat na Marketplace zadejte Konfigurace aplikace a vyberte ENTER.

   

2. Ve výsledcích hledání vyberte Konfigurace aplikace a pak vyberte vytvořit.

   

3. V podokně vytvořit konfiguraci aplikace zadejte následující nastavení:

   Nastavení	Navrhovaná hodnota	Popis
   Předplatné	Vaše předplatné	Vyberte předplatné Azure, které chcete použít k testování konfigurace aplikace. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a seznam předplatných se nezobrazí.
   Skupina prostředků	AppConfigTestResources	Vyberte nebo vytvořte skupinu prostředků pro prostředek úložiště konfigurace aplikace. Tato skupina je užitečná k organizování více prostředků, které můžete chtít odstranit současně odstraněním skupiny prostředků. Další informace najdete v tématu použití skupin prostředků ke správě prostředků Azure.
   Název prostředku	Globálně jedinečný název	Zadejte jedinečný název prostředku, který se má použít pro prostředek úložiště konfigurace aplikace. Název musí být řetězec o 5 až 50 znaků a obsahovat pouze čísla, písmena a - znak. Název nesmí začínat ani končit - znakem.
   Umístění	USA – střed	Umístění použijte k určení geografického umístění, ve kterém je úložiště konfigurace aplikace hostované. Nejlepšího výkonu dosáhnete vytvořením prostředku ve stejné oblasti jako jiné součásti aplikace.
   Cenová úroveň	Free	Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami konfigurace aplikací.

4. Vyberte zkontrolovat + vytvořit a ověřte nastavení.

5. Vyberte Vytvořit. Nasazení může trvat několik minut.

6. Po dokončení nasazení přejděte do prostředku konfigurace aplikace. Vyberte Nastavení > Přístupové klíče. Poznamenejte si primární připojovací řetězec klíče jen pro čtení. Pomocí tohoto připojovacího řetězce později nakonfigurujete aplikaci tak, aby komunikovala s úložištěm konfigurace aplikace, které jste vytvořili.

7. Vyberte možnost Průzkumník konfigurace > + vytvořit > klíč-hodnota a přidejte následující klíč-hodnota:

   Klíč	Hodnota
   TestApp: Nastavení: zpráva	Data z konfigurace aplikace Azure

   Ponechte popisek a typ obsahu prázdné.

vytvoření konzolové aplikace .NET Framework

1. spusťte Visual Studio a vyberte vytvořit nový projekt.

2. v části vytvořit nový projekt, filtrujte podle typu projektu konzoly a vyberte konzolová aplikace (.NET Framework) se C# ze seznamu šablon projektu. Stiskněte tlačítko Další.

3. V konfiguraci nového projektu zadejte název projektu. v části rozhraní vyberte .NET Framework 4.7.2 nebo vyšší. Stiskněte Vytvořit.

Připojení do úložiště konfigurace aplikace

1. klikněte pravým tlačítkem na projekt a vyberte spravovat NuGet balíčky. na kartě procházet vyhledejte a přidejte následující balíčky NuGet do svého projektu.

   • Microsoft. Configuration. ConfigurationBuilders. AzureAppConfiguration verze 1.0.0 nebo novější
   • Microsoft. Configuration. ConfigurationBuilders. Environment verze 2.0.0 nebo novější
   • System. Configuration. ConfigurationManager verze 4.6.0 nebo novější

2. Aktualizujte soubor App.config projektu následujícím způsobem:

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

   Připojovací řetězec úložiště konfigurace aplikace je načtený z proměnné prostředí ConnectionString . Přidejte nástroj Environment Configuration Builder před do MyConfigStore configBuilders vlastnosti appSettings oddílu.

3. Otevřete program. cs a aktualizujte Main metodu tak, aby používala konfiguraci aplikace voláním ConfigurationManager .

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

Sestavte a spusťte aplikaci.

1. Nastavte proměnnou prostředí s názvem ConnectionString na připojovací řetězec klíče jen pro čtení získaný během vytváření úložiště konfigurace aplikace.

   pokud použijete příkazový řádek Windows, spusťte následující příkaz:

   setx ConnectionString "connection-string-of-your-app-configuration-store"
   

   pokud používáte Windows PowerShell, spusťte následující příkaz:

   $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

2. pokud chcete, aby se změna projevila, restartujte Visual Studio.

3. Stisknutím kombinace kláves CTRL + F5 Sestavte a spusťte konzolovou aplikaci. V konzole nástroje by se měla zobrazit zpráva z výstupu konfigurace aplikace.

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste předešli poplatkům.

1. Přihlaste se k Azure Portala vyberte skupiny prostředků.
2. Do pole filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, aby se zobrazil přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název vaší skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

Po chvíli se odstraní skupina prostředků a všechny její prostředky.

Další kroky

v tomto rychlém startu jste vytvořili nové úložiště konfigurace aplikace a použili ho v aplikaci .NET Framework konzolu. další informace o tom, jak aplikaci .NET Framework povolit dynamickou aktualizaci nastavení konfigurace, najdete v dalších kurzech.