Dela via

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 Appinstä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 appinställningarna 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 Portal eller CLI finns i Skapa ett nyckelvärde.

Tangent Värde
TestApp:Settings: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.

Ansluta till ett appkonfigurationsarkiv

Anslut till appkonfigurationsarkivet med Hjälp av Microsoft Entra-ID (rekommenderas) eller en anslutningssträng.

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

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
    • Microsoft.Configuration.ConfigurationBuilders.Environment
    • System.Configuration.ConfigurationManager

  2. Uppdatera Filen App.config för projektet enligt följande. Du kan ansluta till appkonfigurationsarkivet med hjälp av Microsoft Entra-ID (rekommenderas) eller en anslutningssträng.

    Används för att autentisera DefaultAzureCredential till appkonfigurationsarkivet som standard. Följ anvisningarna för att tilldela dina autentiseringsuppgifter rollen App Configuration Data Reader. Se till att ge tillräckligt med tid för att behörigheten ska spridas innan du kör programmet.

    <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" endpoint="${Endpoint}" 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="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
</appSettings>

    Slutpunktsvärdet för appkonfigurationsarkivet läse från miljövariabeln Endpoint. Du lägger också 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.

    Ange en miljövariabel med namnet Slutpunkt till slutpunkten för appkonfigurationsarkivet som finns under Översikt över din butik i Azure Portal.

    Om du använder Windows-kommandotolken kör du följande kommando och startar om kommandotolken så att ändringen börjar gälla:

    setx Endpoint "<endpoint-of-your-app-configuration-store>"

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

    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"

    Om du använder macOS eller Linux kör du följande kommando:

    export Endpoint='<endpoint-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 Portal 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