Sdílet prostřednictvím

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

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

  • Tvůrce konfigurace pro konfiguraci aplikace umožňuje načtení dat z konfigurace aplikace 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, nastavení aplikace 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.

Klíč Hodnota
TestApp:Settings: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í ke službě App Configuration Store

Připojte se ke službě App Configuration Store pomocí Microsoft Entra ID (doporučeno) nebo připojovací řetězec.

  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 nejnovější stabilní verze následujících balíčků NuGet.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
    • Microsoft.Configuration.ConfigurationBuilders.Environment
    • System.Configuration.ConfigurationManager

  2. Následujícím způsobem aktualizujte soubor App.config projektu. Ke službě App Configuration Store se můžete připojit pomocí Microsoft Entra ID (doporučeno) nebo připojovací řetězec.

    Ve DefaultAzureCredential výchozím nastavení se používá k ověření ve službě App Configuration Store. Postupujte podle pokynů a přiřaďte své přihlašovací údaje roli Čtenář dat konfigurace aplikace. Před spuštěním aplikace nezapomeňte povolit dostatek času, než se oprávnění rozšíří.

    <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" endpoint="${Endpoint}" 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="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
</appSettings>

    Hodnota koncového bodu úložiště App Configuration store se načte z proměnné Endpointprostředí . Tvůrce konfigurace přidáte Environment také před MyConfigStoreconfigBuilders vlastnost oddílu appSettings .

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

    Nastavte proměnnou prostředí s názvem Koncový bod na koncový bod úložiště app Configuration, který najdete v části Přehled obchodu na webu Azure Portal.

    Pokud používáte příkazový řádek systému Windows, spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:

    setx Endpoint "<endpoint-of-your-app-configuration-store>"

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

    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"

    Pokud používáte macOS nebo Linux, spusťte následující příkaz:

    export Endpoint='<endpoint-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

  • Last updated on