Szybki start: tworzenie aplikacji .NET Framework przy użyciu konfiguracji aplikacja systemu Azure
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
- Konto platformy Azure z aktywną subskrypcją. Utwórz je bezpłatnie.
- Magazyn usługi App Configuration. Utwórz magazyn.
- Program Visual Studio
- .NET Framework 4.7.2 lub nowszy
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
Uruchom program Visual Studio i wybierz pozycję Utwórz nowy projekt.
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.
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
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
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.EnvironmentDodaj konstruktora konfiguracji przedMyConfigStorewłaściwościąconfigBuildersappSettingssekcji .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ę
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"Uruchom ponownie program Visual Studio, aby umożliwić zastosowanie zmiany.
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.
- Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
- W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
- Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
- Wybierz pozycję Usuń grupę zasobów.
- 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.