Udostępnij za pośrednictwem

Szybki start: tworzenie aplikacji .NET Framework przy użyciu konfiguracji aplikacja systemu Azure

  • Artykuł

Istnieją dwa sposoby dołączania aplikacja systemu Azure Configuration do aplikacji opartej na programie .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, ponieważ zawsze wykonuje ją 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 przeprowadzi Cię przez tę opcję.
  • Zgodnie z założeniami programu .NET Framework ustawienia aplikacji mogą być odświeżane tylko po ponownym uruchomieniu aplikacji. Dostawca .NET 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 wartości klucz-wartości do magazynu przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia, przejdź do artykułu Create a key-value (Tworzenie wartości klucza).

Key Wartość
TestApp:Settings:Message Dane z konfiguracji aplikacja systemu Azure

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

Nawiąż połączenie ze sklepem App Configuration przy użyciu identyfikatora Entra firmy Microsoft (zalecane) lub parametry 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.

    Element DefaultAzureCredential jest używany do uwierzytelniania w magazynie usługi App Configuration domyślnie. Postępuj zgodnie z instrukcjami, aby przypisać poświadczenia roli Czytelnik danych konfiguracji aplikacji. Przed uruchomieniem aplikacji należy zezwolić na wystarczający czas na propagację uprawnień.

    <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ć Environment konstruktora konfiguracji przed MyConfigStore właściwością configBuildersappSettings w sekcji .

  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 punkt końcowy magazynu App Configuration znalezionego w obszarze Przegląd sklepu w witrynie Azure Portal.

    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 "<endpoint-of-your-app-configuration-store>"

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

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

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

    export Endpoint='<endpoint-of-your-app-configuration-store>'

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

  3. Naciśnij Ctrl + F5, aby skompilować i uruchomić aplikację konsolową. W konsoli powinien zostać wyświetlony komunikat z danych wyjściowych usługi App Configuration.

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 przypadkowo nieprawidłowej grupy zasobów ani 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. Zobaczysz prośbę 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 z aplikacją konsolową 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