Szybki start: tworzenie aplikacji platformy .NET przy użyciu usługi App Configuration

W tym przewodniku Szybki start uwzględnisz aplikacja systemu Azure Configuration w aplikacji konsolowej platformy .NET, aby scentralizować magazyn i zarządzać ustawieniami aplikacji niezależnie od kodu.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz je bezpłatnie.
• Magazyn usługi App Configuration. Utwórz magazyn.
• Zestaw .NET SDK 6.0 lub nowszy — dostępny również w usłudze Azure Cloud Shell.

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 platformy .NET

Interfejs wiersza polecenia platformy .NET umożliwia utworzenie nowego projektu aplikacji konsolowej platformy .NET. Zaletą korzystania z interfejsu wiersza polecenia platformy .NET za pośrednictwem programu Visual Studio jest to, że jest ona dostępna na platformach Windows, macOS i Linux. Alternatywnie użyj wstępnie zainstalowanych narzędzi dostępnych w usłudze Azure Cloud Shell.

1. Utwórz nowy folder dla projektu.

2. W nowym folderze uruchom następujące polecenie, aby utworzyć nowy projekt aplikacji konsolowej platformy .NET:

   dotnet new console
   

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

Możesz nawiązać połączenie ze sklepem App Configuration przy użyciu identyfikatora Entra firmy Microsoft (zalecane) lub parametry połączenia.

1. Dodaj odwołania do pakietu NuGet, uruchamiając następujące polecenie:

   Microsoft Entra ID (zalecane)

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   dotnet add package Azure.Identity
   

   Parametry połączenia

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Uruchom następujące polecenie, aby przywrócić pakiety dla projektu:

   dotnet restore
   

3. Otwórz plik Program.cs i dodaj następujące przestrzenie nazw:

   Microsoft Entra ID (zalecane)

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Azure.Identity;
   

   Parametry połączenia

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   

4. Połącz się z magazynem usługi App Configuration, wywołując metodę AddAzureAppConfiguration Program.cs w pliku .

   Microsoft Entra ID (zalecane)

   Użyj polecenia DefaultAzureCredential , aby uwierzytelnić się w magazynie usługi App Configuration. 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ń.

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(options =>
   {
       string endpoint = Environment.GetEnvironmentVariable("Endpoint");
       options.Connect(new Uri(endpoint), new DefaultAzureCredential());
   });
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

   Parametry połączenia

   var builder = new ConfigurationBuilder();
   builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
   
   var config = builder.Build();
   Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   

Lokalne kompilowanie i uruchamianie aplikacji

1. Ustaw zmienną środowiskową.

   Microsoft Entra ID (zalecane)

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

   Parametry połączenia

   Ustaw zmienną środowiskową o nazwie ConnectionString na parametry połączenia tylko do odczytu magazynu App Configuration znajdującego się w obszarze Klucze dostępu 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 ConnectionString "<connection-string-of-your-app-configuration-store>"
   

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

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

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

   export ConnectionString='<connection-string-of-your-app-configuration-store>'
   

2. Uruchom następujące polecenie, aby skompilować aplikację konsolową:

   dotnet build
   

3. Po pomyślnym zakończeniu kompilacji uruchom następujące polecenie, aby uruchomić aplikację lokalnie:

   dotnet run
   

   

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 za pośrednictwem dostawcy usługi App Configuration. Aby dowiedzieć się, jak skonfigurować aplikację .NET w celu dynamicznego odświeżania ustawień konfiguracji, przejdź do następnego samouczka.

Włączanie konfiguracji dynamicznej