Hızlı Başlangıç: Azure Uygulaması Yapılandırması ile .NET Framework uygulaması oluşturma

Makale
05/24/2024

Azure Uygulaması Yapılandırmasını .NET Framework tabanlı bir uygulamaya eklemenin iki yolu vardır.

Uygulama Yapılandırması yapılandırma oluşturucusu, Uygulama Yapılandırması verilerinin App Ayarlar'a yüklenmesini sağlar. Uygulamanız yapılandırmaya her zaman aracılığıyla ConfigurationManagereriştiği gibi erişir. app.config veya web.config dosyalarında yapılan güncelleştirmeler dışında herhangi bir kod değişikliği yapmanız gerekmez. Bu hızlı başlangıç, bu seçenekte size yol gösterir.
.NET Framework tarafından tasarlandığı gibi, Uygulama Ayarlar yalnızca uygulama yeniden başlatıldığında yenilenebilir. .NET sağlayıcısı Uygulama Yapılandırması bir .NET Standart 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 gerekliyse ve kod değişiklikleri yapmak istiyorsanız, .NET Framework konsol uygulamasında veya ASP.NET bir web uygulamasında dinamik yapılandırma güncelleştirmelerini nasıl uygulayabileceğinize ilişkin öğreticilere bakın.

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

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir tane oluşturun.
bir Uygulama Yapılandırması mağazası. Mağaza oluşturma.
Visual Studio
.NET Framework 4.7.2 veya üzeri

Anahtar-değer ekleme

Uygulama Yapılandırması deposuna aşağıdaki anahtar değerini ekleyin ve Etiket ve İçerik Türü değerlerini varsayılan değerleriyle bırakın. Azure portalını veya CLI'yı kullanarak bir depoya anahtar-değer ekleme hakkında daha fazla bilgi için Anahtar-değer oluşturma bölümüne gidin.

Anahtar	Değer
TestApp:Ayarlar:Message	Azure Uygulaması Yapılandırmasından Veriler

.NET Framework konsol uygulaması oluşturma

Visual Studio'yu başlatın ve Yeni proje oluştur'u seçin.
Yeni proje oluştur bölümünde Konsol proje türüne göre filtreleyin ve proje şablonu listesinden C# ile Konsol Uygulaması (.NET Framework) seçeneğini belirleyin. İleri'ye basın.
Yeni projenizi yapılandırın bölümüne bir proje adı girin. Framework'ün altında .NET Framework 4.7.2 veya üzerini seçin. Oluştur’a basın.

Uygulama Yapılandırması mağazasına Bağlan

Projenize sağ tıklayın ve NuGet Paketlerini Yönet'i seçin. Gözat sekmesinde, aşağıdaki NuGet paketlerini arayın ve projenize ekleyin.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration sürüm 1.0.0 veya üzeri
- Microsoft.Configuration.ConfigurationBuilders.Environment sürüm 2.0.0 veya üzeri
- System.Configuration.ConfigurationManager sürüm 4.6.0 veya üzeri

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ırması deponuzun bağlantı dizesi ortam değişkeninden ConnectionStringokunur. Environment bölümünün özelliğinden configBuilders önce MyConfigStore yapılandırma oluşturucusunu appSettings ekleyin.

Program.cs açın ve yöntemini çağırarak ConfigurationManagerUygulama Yapılandırması kullanacak şekilde güncelleştirinMain.

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

Bağlan ionString adlı bir ortam değişkenini, Uygulama Yapılandırması deposu oluşturma sırasında elde edilen salt okunur anahtar bağlantı dizesi ayarlayın.

Windows komut istemini kullanıyorsanız aşağıdaki komutu çalıştırın:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Windows PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Değişikliğin etkili olması için Visual Studio'yu yeniden başlatın.
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örmeniz gerekir.

Kaynakları temizleme

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

Önemli

Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu makalenin kaynaklarını, saklamak istediğiniz diğer kaynakları içeren bir kaynak grubu içinde oluşturduysanız, kaynak grubunu silmek yerine her kaynağı ilgili bölmeden tek tek silin.

Azure portalında oturum açın ve Kaynak grupları'nı seçin.
Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
Kaynak grubunu sil'i seçin.
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ırması deposu oluşturdunuz ve bunu bir .NET Framework konsol uygulamasıyla kullandınız. .NET Framework uygulamanızın yapılandırma ayarlarını dinamik olarak yenilemesini nasıl etkinleştireceğinizi öğrenmek için sonraki öğreticilere geçin.

.NET Framework uygulamasında dinamik yapılandırmayı etkinleştirme

ASP.NET web uygulamasında dinamik yapılandırmayı etkinleştirme

Aracılığıyla paylaş