Hızlı Başlangıç: .NET Framework ile Azure Uygulama Yapılandırması

Uygulama tabanlı bir uygulamaya Azure Uygulama Yapılandırması iki .NET Framework yolu vardır.

• Uygulama Yapılandırması için yapılandırma oluşturucusu, Uygulama Yapılandırması'nın verilerini App Ayarlar. Her zaman aracılığıyla yaptığı gibi, uygulamanız yapılandırmaya ConfigurationManager erişer. Dosyalarda veya dosyalarda yapılan güncelleştirmeler dışında kod değişikliğiapp.config web.config yok. Bu hızlı başlangıç, bu seçenekte size yol ver.
• Uygulama hizmeti tarafından .NET Framework, App Ayarlar yalnızca uygulama yeniden başlatıldığında yenilenir. Uygulama Yapılandırması .NET sağlayıcısı bir .NET Standard kitaplığıdır. Uygulama yeniden başlatma olmadan yapılandırmayı dinamik olarak önbelleğe almayı ve yenilemeyi destekler. Dinamik yapılandırma sizin için temelse ve kod değişiklikleri yapmaya istekliyebilirsiniz, bir .NET Framework konsol uygulamasında veya bir ASP.NET web uygulamasında dinamik yapılandırma güncelleştirmelerini nasıl uygulayabilirsiniz öğreticilere bakın.

Bu hızlı başlangıçta bir .NET Framework konsol uygulaması örnek olarak kullanılır, ancak aynı teknik bir ASP.NET Web Forms/MVC uygulaması için de geçerlidir.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Visual Studio
• .NET Framework 4.7.2 veya sonraki bir

Uygulama Yapılandırma deposu oluşturma

1. Yeni bir uygulama yapılandırma deposu oluşturmak için Azure Portaloturum açın. Giriş sayfasının sol üst köşesinde kaynak oluştur' u seçin. Market 'te Ara kutusuna uygulama yapılandırması ' nı girin ve ENTER' u seçin.

   

2. Arama sonuçlarından uygulama yapılandırması ' nı seçin ve ardından Oluştur' u seçin.

   

3. Uygulama yapılandırması oluştur bölmesinde, aşağıdaki ayarları girin:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Aboneliğiniz	Uygulama yapılandırmasını test etmek için kullanmak istediğiniz Azure aboneliğini seçin. Hesabınızda yalnızca bir abonelik varsa, bu otomatik olarak seçilir ve abonelik listesi gösterilmez.
   Kaynak grubu	AppConfigTestResources	Uygulama yapılandırma deposu kaynağınız için bir kaynak grubu seçin veya oluşturun. Bu grup, kaynak grubunu silerek aynı anda silmek isteyebileceğiniz birden çok kaynağı düzenlemek için yararlıdır. Daha fazla bilgi için Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma konusunu inceleyin.
   Kaynak adı	Genel olarak benzersiz bir ad	Uygulama yapılandırma deposu kaynağı için kullanılacak benzersiz bir kaynak adı girin. Ad, 5 ila 50 karakter arasında bir dize olmalı ve yalnızca rakam, harf ve - karakter içermelidir. Ad, karakteriyle başlayamaz veya bitemez - .
   Konum	Central US	Uygulama yapılandırma deponuzın barındırıldığı coğrafi konumu belirtmek için konum ' i kullanın. En iyi performansı elde etmek için, kaynağı uygulamanızın diğer bileşenleriyle aynı bölgede oluşturun.
   Fiyatlandırma katmanı	Ücretsiz	İstediğiniz fiyatlandırma katmanını seçin. Daha fazla bilgi için bkz. uygulama yapılandırma fiyatlandırma sayfası.

4. Ayarlarınızı doğrulamak için gözden geçir + oluştur ' u seçin.

5. Oluştur’u seçin. Dağıtım birkaç dakika sürebilir.

6. Dağıtım bittikten sonra uygulama yapılandırma kaynağına gidin. Ayarlar > Erişim anahtarları öğesini seçin. Birincil salt okunurdur anahtar bağlantı dizesini bir yere unutmayın. Uygulamanızı oluşturduğunuz uygulama yapılandırma deposuyla iletişim kuracak şekilde yapılandırmak için bu bağlantı dizesini daha sonra kullanacaksınız.

7. Aşağıdaki anahtar-değeri > eklemek için Yapılandırma gezgini + > Anahtar-değer Oluştur'a tıklayın:

   Anahtar	Değer
   TestApp:Ayarlar:Message	Azure Uygulama Yapılandırması'den veriler

   Etiket ve İçerik Türü'leri boş bırakın.

.NET Framework konsol uygulaması oluşturma

1. Yeni Visual Studio ve Yeni proje oluştur'a seçin.

2. Yeni proje oluştur'da Konsol proje türünü filtrelenin ve proje şablonu listesinden C# ile Konsol Uygulaması (.NET Framework) öğesini seçin. Sonraki'ne basın.

3. Yeni projenizi yapılandırma alanına bir proje adı girin. Framework altında, 4.7.2 veya .NET Framework'ı seçin. Oluştur’a basın.

Bağlan Yapılandırma deposuna yapılandırma

1. Projenize sağ tıklayın ve Paketleri Yönet'NuGet seçin. Gözat sekmesinde aşağıdaki paket paketlerini arayın ve NuGet ekleyin.

   • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration sürüm 1.0.0 veya sonrası
   • Microsoft.Configuration.ConfigurationBuilders.Environment sürüm 2.0.0 veya sonrası
   • System.Configuration.ConfigurationManager sürüm 4.6.0 veya sonraki sürümler

2. Projenizin App.config dosyasını aşağıdaki gibi güncelleştirin:

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

   Uygulama Yapılandırma mağazanıza bağlantı dizesi ortam değişkenini ConnectionString okur. yapılandırma Environment oluşturucus nu bölümünün MyConfigStore configBuilders özelliğinde 'den önce appSettings ekleyin.

3. Program.cs'yi açın ve Main çağırarak App Configuration'ı kullanmak için yöntemini güncelleştirin. ConfigurationManager

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

Uygulamayı derleyin ve çalıştırın

1. ConnectionString adlı bir ortam değişkenini, Uygulama Yapılandırma deposu oluşturma işlemi sırasında alınan salt okunur anahtar bağlantı dizesine ayarlayın.

   Windows komut istemini kullanırsanız aşağıdaki komutu çalıştırın:

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

   Aşağıdaki komutu Windows PowerShell çalıştırın:

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

2. Değişikliğin Visual Studio izin vermek için yeniden başlatın.

3. Konsol uygulamasını derlemek ve çalıştırmak için Ctrl + F5 tuşlarına basın. Konsolda Uygulama Yapılandırması çıkışlarından gelen iletiyi görüyor olun.

Kaynakları temizleme

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız, ücretlendirmemek için burada oluşturduğunuz kaynak grubunu silin.

1. Azure Portaloturum açın ve kaynak grupları' nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Sonuç listesinde, bir genel bakışı görmek için kaynak grubu adını seçin.
4. Kaynak grubunu sil'i seçin.
5. Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil' i seçin.

Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.

Sonraki adımlar

Bu hızlı başlangıçta, yeni bir Uygulama Yapılandırma deposu oluşturdunız ve bunu bir .NET Framework uygulamasıyla kullandınız. .NET Framework uygulamanıza yapılandırma ayarlarını dinamik olarak yenilemeyi etkinleştirme hakkında bilgi edinmek için sonraki öğreticilere devam edin.