Szybki start: tworzenie aplikacji .NET Framework za pomocą Azure App Configuration

Istnieją dwa sposoby zintegrowania usługi Azure App Configuration z aplikacją opartą na platformie .NET Framework.

  • Konstruktor konfiguracji dla usługi App Configuration umożliwia ładowanie danych z usługi App Configuration do ustawień aplikacji. Aplikacja uzyskuje dostęp do konfiguracji tak jak zawsze, za pośrednictwem metody ConfigurationManager. Nie musisz wprowadzać żadnych zmian kodu innych niż aktualizacje plików app.config lub web.config . Ten przewodnik Szybki start omawia tę opcję.
  • Zgodnie z założeniami programu .NET Framework ustawienia aplikacji mogą być odświeżane tylko po ponownym uruchomieniu aplikacji. Dostawca platformy .NET dla usługi App Configuration to biblioteka .NET Standard. Obsługuje ona buforowanie i odświeżanie konfiguracji dynamicznie bez ponownego uruchamiania aplikacji. Jeśli konfiguracja dynamiczna jest niezbędna dla Ciebie i chcesz wprowadzić zmiany w kodzie, zobacz samouczki dotyczące sposobu implementowania dynamicznych aktualizacji konfiguracji w aplikacji konsolowej .NET Framework lub aplikacji internetowej ASP.NET.

W tym przewodniku Szybki start aplikacja konsolowa platformy .NET Framework jest używana jako przykład, ale ta sama technika dotyczy aplikacji ASP.NET Web Forms/MVC.

Wymagania wstępne

Dodawanie wartości klucza

Dodaj następującą wartość klucza do magazynu App Configuration i pozostaw wartości domyślne Etykieta i Typ zawartości. Aby uzyskać więcej informacji na temat dodawania par klucz-wartość do magazynu przy użyciu portalu Azure lub interfejsu wiersza polecenia, przejdź do artykułu Create a key-value.

Klawisz Wartość
TestApp:Settings:Message Dane z usługi Azure App Configuration

Tworzenie aplikacji konsolowej .NET Framework

  1. Uruchom program Visual Studio i wybierz pozycję Utwórz nowy projekt.

  2. W obszarze Tworzenie nowego projektu przefiltruj typ projektu Konsola i wybierz pozycję Aplikacja konsolowa (.NET Framework) przy użyciu języka C# z listy szablonów projektu. Naciśnij przycisk Dalej.

  3. W obszarze Konfigurowanie nowego projektu wprowadź nazwę projektu. W obszarze Framework wybierz pozycję .NET Framework 4.7.2 lub nowszy. Kliknij przycisk Utwórz.

Nawiązywanie połączenia z magazynem usługi App Configuration

Połącz się z magazynem App Configuration przy użyciu Microsoft Entra ID (zalecane) lub parametrów połączenia.

  1. Kliknij projekt prawym przyciskiem myszy i wybierz polecenie Zarządzaj pakietami NuGet. Na karcie Przeglądaj wyszukaj i dodaj do projektu najnowsze stabilne wersje następujących pakietów NuGet.

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

  2. Zaktualizuj plik App.config projektu w następujący sposób. Możesz nawiązać połączenie ze sklepem App Configuration przy użyciu identyfikatora Entra firmy Microsoft (zalecane) lub parametry połączenia.

    DefaultAzureCredential jest domyślnie używany do uwierzytelniania dostępu do magazynu usługi App Configuration. Postępuj zgodnie z instrukcjami, aby przypisać swoim poświadczeniom rolę Czytelnik danych konfiguracji aplikacji. Przed uruchomieniem aplikacji należy odczekać odpowiednio dużo czasu, aż uprawnienia się rozpropagują.

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

    Wartość punktu końcowego magazynu usługi App Configuration jest odczytywana ze zmiennej środowiskowej Endpoint. Należy również dodać konstruktor konfiguracji Environment przed MyConfigStore we właściwości configBuilders sekcji appSettings.

  3. Otwórz Program.cs i zaktualizuj metodę Main , aby używać usługi App Configuration, wywołując metodę ConfigurationManager.

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

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

Skompiluj i uruchom aplikację

  1. Ustaw zmienną środowiskową.

    Ustaw zmienną środowiskową o nazwie Endpoint na wartość punktu końcowego magazynu usługi App Configuration widoczną na karcie Przegląd tego magazynu w portalu Azure.

    Jeśli używasz wiersza polecenia systemu Windows, uruchom następujące polecenie i uruchom ponownie wiersz polecenia, aby zezwolić na wprowadzenie zmian:

    setx Endpoint "<AppConfigurationEndpoint>"

    Jeśli używasz programu PowerShell, uruchom następujące polecenie:

    $Env:Endpoint = "<AppConfigurationEndpoint>"

    Jeśli używasz systemu macOS lub Linux, uruchom następujące polecenie:

    export Endpoint='<AppConfigurationEndpoint>'

  2. Uruchom ponownie program Visual Studio, aby umożliwić zastosowanie zmiany.

  3. Naciśnij Ctrl+F5, aby zbudować i uruchomić aplikację konsolową. Widzisz komunikat z Konfiguracji aplikacji w konsoli.

Czyszczenie zasobów

Jeśli nie chcesz nadal korzystać z zasobów utworzonych w tym artykule, usuń utworzoną tutaj grupę zasobów, aby uniknąć naliczania opłat.

Ważne

Usunięcie grupy zasobów jest nieodwracalne. Grupa zasobów i wszystkie zasoby w niej są trwale usuwane. Upewnij się, że nie usuniesz przez przypadek niewłaściwej grupy zasobów lub zasobów. Jeśli zasoby dla tego artykułu zostały utworzone w grupie zasobów zawierającej inne zasoby, które chcesz zachować, usuń każdy zasób oddzielnie z odpowiedniego okienka zamiast usuwać grupę zasobów.

  1. Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
  2. W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
  3. Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
  4. Wybierz pozycję Usuń grupę zasobów.
  5. Zostaniesz poproszony o potwierdzenie usunięcia grupy zasobów. Wprowadź nazwę grupy zasobów, aby potwierdzić, a następnie wybierz pozycję Usuń.

Po kilku chwilach grupa zasobów i wszystkie jej zasoby zostaną usunięte.

Następne kroki

W tym przewodniku Szybki start utworzono nowy magazyn App Configuration i użyto go w aplikacji konsolowej platformy .NET Framework. Aby dowiedzieć się, jak umożliwić aplikacji .NET Framework dynamiczne odświeżanie ustawień konfiguracji, przejdź do następnych samouczków.

Włączanie dynamicznej konfiguracji w aplikacji .NET Framework

Włączanie dynamicznej konfiguracji w aplikacji internetowej ASP.NET

  • Last updated on