Snabbstart: Skapa en .NET Framework-app med Azure App Configuration

  • Artikel

Det finns två sätt att införliva Azure App Configuration i en .NET Framework-baserad app.

  • Konfigurationsverktyget för App Configuration gör att data från App Configuration kan läsas in till App Inställningar. Din app kommer åt konfigurationen som den alltid gör via ConfigurationManager. Du behöver inte göra någon annan kodändring än uppdateringar av app.config - eller web.config-filer . Den här snabbstarten vägleder dig genom det här alternativet.
  • Som är utformat av .NET Framework kan app-Inställningar bara uppdateras när programmet startas om. .NET-providern för appkonfiguration är ett .NET Standard-bibliotek. Den stöder cachelagring och uppdatering av konfigurationen dynamiskt utan omstart av programmet. Om den dynamiska konfigurationen är nödvändig för dig och du är villig att göra kodändringar kan du läsa självstudier om hur du kan implementera dynamiska konfigurationsuppdateringar i en .NET Framework-konsolapp eller en ASP.NET webbapp.

I den här snabbstarten används en .NET Framework-konsolapp som ett exempel, men samma teknik gäller för en ASP.NET Web Forms/MVC-app.

Förutsättningar

Lägga till ett nyckelvärde

Lägg till följande nyckelvärde i appkonfigurationsarkivet och lämna Etikett och innehållstyp med sina standardvärden. Mer information om hur du lägger till nyckelvärden i ett arkiv med hjälp av Azure-portalen eller CLI finns i Skapa ett nyckelvärde.

Tangent Värde
TestApp:Inställningar:Message Data från Azure App Configuration

Skapa en .NET Framework-konsolapp

  1. Starta Visual Studio och välj Skapa ett nytt projekt.

  2. I Skapa ett nytt projekt filtrerar du på projekttypen Konsol och väljer Konsolapp (.NET Framework) med C# i listan med projektmallar. Tryck på Nästa.

  3. I Konfigurera det nya projektet anger du ett projektnamn. Under Framework väljer du .NET Framework 4.7.2 eller senare. Tryck på Skapa.

Anslut till ett appkonfigurationsarkiv

  1. Högerklicka på projektet och välj Hantera NuGet-paket. På fliken Bläddra söker du efter och lägger till följande NuGet-paket i projektet.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration version 1.0.0 eller senare
    • Microsoft.Configuration.ConfigurationBuilders.Environment version 2.0.0 eller senare
    • System.Configuration.ConfigurationManager version 4.6.0 eller senare

  2. Uppdatera App.config-filen för projektet på följande sätt:

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

    Anslutningssträng i appkonfigurationsarkivet läse från miljövariabeln ConnectionString. Lägg till konfigurationsverktyget Environment före MyConfigStore i - configBuilders egenskapen för appSettings avsnittet.

  3. Öppna Program.cs och uppdatera Main metoden för att använda App Configuration genom att anropa ConfigurationManager.

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

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

Kompilera och köra appen

  1. Ange en miljövariabel med namnet Anslut ionString till den skrivskyddade nyckeln anslutningssträng som erhölls när appkonfigurationsarkivet skapades.

    Om du använder Windows-kommandotolken kör du följande kommando:

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

    Om du använder Windows PowerShell kör du följande kommando:

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

  2. Starta om Visual Studio så att ändringen börjar gälla.

  3. Tryck på Ctrl + F5 för att skapa och köra konsolappen. Du bör se meddelandet från App Configuration-utdata i konsolen.

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapas i den här artikeln tar du bort resursgruppen som du skapade här för att undvika avgifter.

Viktigt!

Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser i den tas bort permanent. Se till att du inte oavsiktligt tar bort fel resursgrupp eller resurser. Om du har skapat resurserna för den här artikeln i en resursgrupp som innehåller andra resurser som du vill behålla tar du bort varje resurs individuellt från respektive fönster i stället för att ta bort resursgruppen.

  1. Logga in på Azure-portalen och välj Resursgrupper.
  2. I rutan Filtrera efter namn anger du namnet på resursgruppen.
  3. I resultatlistan väljer du resursgruppens namn för att se en översikt.
  4. Välj Ta bort resursgrupp.
  5. Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resursgruppen för att bekräfta och välj Ta bort.

Efter en liten stund tas resursgruppen och alla dess resurser bort.

Nästa steg

I den här snabbstarten skapade du ett nytt appkonfigurationsarkiv och använde det med en .NET Framework-konsolapp. Om du vill lära dig hur du gör så att .NET Framework-appen dynamiskt uppdaterar konfigurationsinställningarna fortsätter du till nästa självstudier.

Aktivera dynamisk konfiguration i en .NET Framework-app

Aktivera dynamisk konfiguration i en ASP.NET webbapp