Snabbstart: Skapa en .NET Framework med Azure App Configuration

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 i App Inställningar. Din app har åtkomst till konfigurationen som den alltid gör via ConfigurationManager . Du behöver inte göra några andra kodförändringar än uppdateringar av app.config eller web.config filer. I den här snabbstarten går vi igenom det här alternativet.
• Som har utformats av .NET Framework kan app-Inställningar bara uppdateras när programmet startas om. Den App Configuration .NET-providern är ett .NET-standardbibliotek. Den stöder cachelagring och uppdatering av konfiguration dynamiskt utan omstart av programmet. Om den dynamiska konfigurationen är viktig för dig och du är beredd att göra kodändringar kan du gå 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 .NET Framework en konsolapp som exempel, men samma metod gäller för en ASP.NET Web Forms/MVC-app.

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Visual Studio
• .NET Framework 4.7.2 eller senare

Skapa en App Configuration butik

1. Om du vill skapa ett nytt konfigurations Arkiv för appen loggar du in på Azure Portal. I det övre vänstra hörnet på Start sidan väljer du skapa en resurs. I rutan Sök på Marketplace anger du app-konfiguration och väljer RETUR.

   

2. Välj app-konfiguration från Sök resultaten och välj sedan skapa.

   

3. I fönstret skapa app-konfiguration anger du följande inställningar:

   Inställning	Föreslaget värde	Beskrivning
   Prenumeration	Din prenumeration	Välj den Azure-prenumeration du vill använda för att testa App Configuration. Om ditt konto bara har en prenumeration väljs den automatiskt och ingen prenumerations lista visas.
   Resursgrupp	AppConfigTestResources	Välj eller skapa en resurs grupp för din app Configuration Store-resurs. Den här gruppen är användbar för att organisera flera resurser som du kanske vill ta bort samtidigt genom att ta bort resurs gruppen. Mer information finns i använda resurs grupper för att hantera dina Azure-resurser.
   Resurs namn	Globalt unikt namn	Ange ett unikt resurs namn som ska användas för appens konfigurations Arkiv resurs. Namnet måste vara en sträng mellan 5 och 50 tecken och får bara innehålla siffror, bokstäver och - tecknet. Namnet får inte börja eller sluta med - specialtecknet.
   Plats	USA, centrala	Använd Plats till att ange den geografiska plats där appkonfigurationsarkivets resurs finns. För bästa prestanda skapar du resursen i samma region som andra komponenter i ditt program.
   Prisnivå	Kostnadsfri	Välj önskad pris nivå. Mer information finns på sidan med prissättning för app-konfiguration.

4. Välj Granska + skapa för att validera inställningarna.

5. Välj Skapa. Distributionen kan ta några minuter.

6. När distributionen är klar går du till appen konfigurations resurs. Välj Inställningar > Åtkomstnycklar. Anteckna den primära skrivskyddade nyckel anslutnings strängen. Du kommer att använda den här anslutnings strängen senare för att konfigurera programmet för att kommunicera med det app-konfigurations lager som du har skapat.

7. Välj Configuration Explorer+ Create Key-value (Konfigurationsutforskaren + Skapa > > nyckelvärde) för att lägga till följande nyckelvärde:

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

   Lämna Etikett och Innehållstyp tomma.

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# från listan med projektmallar. Tryck på Nästa.

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

Anslut till en App Configuration butik

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 i 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ängen för ditt App Configuration läses från miljövariabeln ConnectionString . Lägg till Environment konfigurationsverktyget MyConfigStore före i configBuilders -egenskapen för appSettings -avsnittet.

3. Öppna Program.cs och uppdatera metoden så Main att den använder 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 ConnectionString till den skrivskyddade nyckelanslutningssträngen som erhölls när App Configuration arkivet 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 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 skapats i den här artikeln tar du bort resurs gruppen som du skapade här för att undvika avgifter.

1. Logga in på Azure Portaloch välj resurs grupper.
2. I rutan Filtrera efter namn anger du namnet på din resurs grupp.
3. I listan resultat väljer du resurs gruppens 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å resurs gruppen som ska bekräftas och välj ta bort.

Efter en liten stund tas resurs gruppen och alla dess resurser bort.

Nästa steg

I den här snabbstarten har du skapat en App Configuration store och använt den med en .NET Framework-konsolapp. Om du vill lära dig hur du .NET Framework din app för att dynamiskt uppdatera konfigurationsinställningarna fortsätter du till nästa självstudier.