Rychlý start: Vytvoření aplikace .NET Framework pomocí konfigurace Aplikace Azure

  • Článek

Existují dva způsoby, jak začlenit Aplikace Azure Konfigurace do aplikace založené na rozhraní .NET Framework.

  • Tvůrce konfigurace pro službu App Configuration umožňuje načtení dat ze služby App Configuration do Nastavení aplikace. Vaše aplikace přistupuje ke konfiguraci tak, jak to vždy dělá .ConfigurationManager Nemusíte provádět jiné změny kódu než aktualizace souborů app.config nebo web.config . Tato rychlá zprovoznění vás provede touto možností.
  • Jak je navrženo rozhraním .NET Framework, aplikace Nastavení se může aktualizovat pouze po restartování aplikace. Zprostředkovatel .NET Konfigurace aplikace je knihovna .NET Standard. Podporuje dynamicky ukládání do mezipaměti a aktualizaci konfigurace bez restartování aplikace. Pokud je pro vás dynamická konfigurace nezbytná a jste ochotni provádět změny kódu, přečtěte si kurzy o tom, jak můžete implementovat dynamické aktualizace konfigurace v konzolové aplikaci rozhraní .NET Framework nebo ve webové aplikaci ASP.NET.

V tomto rychlém startu se jako příklad používá konzolová aplikace rozhraní .NET Framework, ale stejná technika platí pro aplikaci ASP.NET Webových formulářů nebo MVC.

Požadavky

Přidání hodnoty klíče

Přidejte do obchodu App Configuration následující klíč-hodnota a ponechte popisek a typ obsahu s výchozími hodnotami. Další informace o tom, jak přidat hodnoty klíčů do úložiště pomocí webu Azure Portal nebo rozhraní příkazového řádku, najdete v tématu Vytvoření hodnoty klíče.

Key Hodnota
TestApp:Nastavení:Message Data z konfigurace Aplikace Azure

Vytvoření konzolové aplikace rozhraní .NET Framework

  1. Spusťte Visual Studio a vyberte Vytvořit nový projekt.

  2. V části Vytvořit nový projekt vyfiltrujte typ projektu konzoly a ze seznamu šablon projektu vyberte Konzolová aplikace (.NET Framework) s jazykem C#. Stiskněte další.

  3. Do pole Konfigurovat nový projekt zadejte název projektu. V části Framework vyberte rozhraní .NET Framework 4.7.2 nebo vyšší. Stiskněte tlačítko Vytvořit.

Připojení do App Configuration Storu

  1. Klikněte pravým tlačítkem na projekt a vyberte Spravovat balíčky NuGet. Na kartě Procházet vyhledejte a přidejte do projektu následující balíčky NuGet.

    • 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 vašeho obchodu App Configuration store se načte z proměnné ConnectionStringprostředí . Environment Přidejte tvůrce konfigurace před MyConfigStoreconfigBuilders vlastnost oddíluappSettings.

  3. Otevřete Program.cs a aktualizujte metodu Main tak, aby používala app Configuration 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 Připojení ionString na klíč jen pro čtení připojovací řetězec získanou při vytváření úložiště App Configuration.

    Pokud používáte příkazový řádek systému 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. Restartujte Visual Studio, aby se změna projevila.

  3. Stisknutím kombinace kláves Ctrl+ F5 sestavte a spusťte konzolovou aplikaci. V konzole by se měla zobrazit zpráva z výstupů 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 se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Ujistěte se, že omylem neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste vytvořili prostředky pro tento článek ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.

  1. Přihlaste se k webu Azure Portal a 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ů, abyste zobrazili přehled.
  4. Vyberte Odstranit skupinu prostředků.
  5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.

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

Další kroky

V tomto rychlém startu jste vytvořili nový obchod App Configuration a použili ho s konzolovou aplikací rozhraní .NET Framework. Pokud chcete zjistit, jak povolit aplikaci .NET Framework dynamicky aktualizovat nastavení konfigurace, pokračujte k dalším kurzům.

Povolení dynamické konfigurace v aplikaci .NET Framework

Povolení dynamické konfigurace ve webové aplikaci ASP.NET