Quickstart: Een .NET Framework-app maken met Azure-app-configuratie

Artikel
02/23/2024

Er zijn twee manieren om Azure-app Configuration op te nemen in een .NET Framework-app.

Met de configuratiebouwer voor App Configuration kunnen gegevens van App Configuration worden geladen in app-Instellingen. Uw app heeft toegang tot de configuratie, zoals altijd via ConfigurationManager. U hoeft geen andere codewijziging aan te brengen dan updates voor app.config - of web.config-bestanden . In deze quickstart wordt u begeleid bij deze optie.
Zoals is ontworpen door .NET Framework, kan de app-Instellingen alleen worden vernieuwd wanneer de toepassing opnieuw wordt opgestart. De .NET-provider van App Configuration is een .NET Standard-bibliotheek. Het biedt ondersteuning voor het dynamisch opslaan en vernieuwen van de configuratie zonder dat de toepassing opnieuw hoeft te worden opgestart. Als de dynamische configuratie essentieel is voor u en u bereid bent om codewijzigingen aan te brengen, raadpleegt u zelfstudies over hoe u dynamische configuratie-updates kunt implementeren in een .NET Framework-console-app of een ASP.NET-web-app.

In deze quickstart wordt een .NET Framework-console-app gebruikt als voorbeeld, maar dezelfde techniek is van toepassing op een ASP.NET Web Forms/MVC-app.

Vereisten

Een Azure-account met een actief abonnement. Maak gratis een account.
Een App Configuration-archief. Een winkel maken.
Visual Studio
.NET Framework 4.7.2 of hoger

Een sleutelwaarde toevoegen

Voeg de volgende sleutelwaarde toe aan het App Configuration-archief en laat label en inhoudstype ongewijzigd met de standaardwaarden. Ga naar Een sleutelwaarde maken voor meer informatie over het toevoegen van sleutelwaarden aan een archief met behulp van Azure Portal of de CLI.

Sleutel	Weergegeven als
TestApp:Instellingen:Message	Gegevens uit Azure-app-configuratie

Een .NET Framework-console-app maken

Start Visual Studio en selecteer Een nieuw project maken.
Filter in Een nieuw project maken op het consoleprojecttype en selecteer Console-app (.NET Framework) met C# in de lijst met projectsjablonen. Druk op Volgende.
Voer in Uw nieuwe project configureren een projectnaam in. Selecteer onder Framework .NET Framework 4.7.2 of hoger. Druk op Maken.

Verbinding maken met een App Configuration-archief

Klik met de rechtermuisknop op het project en selecteer NuGet-pakketten beheren. Zoek op het tabblad Bladeren de volgende NuGet-pakketten op en voeg deze toe aan uw project.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration versie 1.0.0 of hoger
- Microsoft.Configuration.ConfigurationBuilders.Environment versie 2.0.0 of hoger
- System.Configuration.ConfigurationManager versie 4.6.0 of hoger

Werk het bestand App.config van uw project als volgt bij:

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

De verbindingstekenreeks van uw App Configuration-archief wordt gelezen vanuit de omgevingsvariabele ConnectionString. Voeg de Environment-configuratiebouwer toe vóór de MyConfigStore in de eigenschap configBuilders van de sectie appSettings.

Open Program.cs en werk de methode Main bij voor het gebruik van App Configuration door de methode ConfigurationManager aan te roepen.

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

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

Ontwikkel de app en voer deze uit

Stel een omgevingsvariabele met de naam Verbinding maken ionString in op de alleen-lezen sleutel verbindingsreeks verkregen tijdens het maken van uw App Configuration-archief.

Als u de Windows-opdrachtprompt gebruikt, moet u de volgende opdracht uitvoeren:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Als u Windows PowerShell gebruikt, voert u de volgende opdracht uit:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Start Visual Studio opnieuw zodat de wijziging kan worden doorgevoerd.
Druk op Ctrl + F5 om de consoletoepassing te bouwen en uit te voeren. U ziet nu het bericht van App Configuration-uitvoer in de console.

Resources opschonen

Als u de resources die in dit artikel zijn gemaakt niet wilt blijven gebruiken, verwijdert u de resourcegroep die u hier hebt gemaakt om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle resources daarin worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert. Als u de resources voor dit artikel in een resourcegroep hebt gemaakt die andere resources bevat die u wilt behouden, moet u elke resource afzonderlijk verwijderen uit het deelvenster in plaats van dat u de resourcegroep verwijdert.

Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
Voer de naam van de resourcegroep in het vak Filteren op naam in.
Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
Selecteer Resourcegroep verwijderen.
U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Voer de naam van de resourcegroep in ter bevestiging en selecteer Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

Volgende stappen

In deze quickstart hebt u een nieuw App Configuration-archief gemaakt en dit gebruikt met een .NET Core console-app. Als u wilt weten hoe u uw .NET Framework-app kunt inschakelen om configuratie-instellingen dynamisch te vernieuwen, gaat u verder met de volgende zelfstudies.

Dynamische configuratie inschakelen in een .NET Framework-app

Dynamische configuratie inschakelen in een ASP.NET-web-app

Share via