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 usługi App Ustawienia. 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ę.
  • Podobnie jak w przypadku programu .NET Framework, Ustawienia aplikacji można odświeżać 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:Ustawienia: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.

Połączenie do magazynu usługi App Configuration

  1. Kliknij projekt prawym przyciskiem myszy i wybierz polecenie Zarządzaj pakietami NuGet. Na karcie Przeglądaj wyszukaj i dodaj następujące pakiety NuGet do projektu.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration w wersji 1.0.0 lub nowszej
    • Microsoft.Configuration.ConfigurationBuilders.Environment w wersji 2.0.0 lub nowszej
    • System.Configuration.ConfigurationManager w wersji 4.6.0 lub nowszej

  2. Zaktualizuj plik App.config projektu w następujący sposób:

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

    Parametry połączenia magazynu App Configuration jest odczytywany ze zmiennej środowiskowej ConnectionString. Environment Dodaj konstruktora konfiguracji przed MyConfigStore właściwością configBuildersappSettings 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ą o nazwie Połączenie ionString na klucz tylko do odczytu parametry połączenia uzyskany podczas tworzenia magazynu usługi App Configuration.

    Jeśli używasz wiersza polecenia systemu Windows, uruchom następujące polecenie:

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

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

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

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

  3. Naciśnij klawisze 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