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

Makale
04/04/2024

Bu hızlı başlangıçta, kodunuzdan ayrı olarak uygulama ayarlarının depolamasını ve yönetimini merkezi hale getirmek için Azure Uygulaması Yapılandırması'nı bir .NET konsol uygulamasına ekleyeceksiniz.

Ö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.
.NET SDK 6.0 veya üzeri - Azure Cloud Shell'de de kullanılabilir.

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 konsol uygulaması oluşturma

Yeni bir .NET konsol uygulaması projesi oluşturmak için .NET komut satırı arabirimini (CLI) kullanabilirsiniz. .NET CLI'yi Visual Studio yerine kullanmanın avantajı, Windows, macOS ve Linux platformları genelinde kullanılabilir olmasıdır. Alternatif olarak, Azure Cloud Shell'de bulunan önceden yüklenmiş araçları da kullanabilirsiniz.

Projeniz için yeni bir klasör oluşturun.
Yeni klasörde aşağıdaki komutu çalıştırarak yeni bir .NET konsol uygulaması projesi oluşturun:
```
dotnet new console
```

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

Aşağıdaki komutu çalıştırarak NuGet paketine başvuru Microsoft.Extensions.Configuration.AzureAppConfiguration ekleyin:
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
Projenizin paketlerini geri yüklemek için aşağıdaki komutu çalıştırın:
```
dotnet restore
```

Program.cs açın ve aşağıdaki deyimleri ekleyin:

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

dosyasında yöntemini AddAzureAppConfigurationProgram.cs çağırarak Uygulama Yapılandırması kullanın.

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

Uygulamayı yerel olarak derleme ve çalıştırma

Bağlan ionString adlı bir ortam değişkeni ayarlayın ve bunu Uygulama Yapılandırması deponuzun erişim anahtarına ayarlayın. Komut satırında aşağıdaki komutu çalıştırın:
Windows komut istemini kullanarak uygulamayı yerel olarak derlemek ve çalıştırmak için aşağıdaki komutu çalıştırın:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Değişikliğin etkili olması için komut istemini yeniden başlatın. Ortam değişkeninin değerini yazdırarak doğru ayarlandığını doğrulayın.
Windows PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
macOS kullanıyorsanız aşağıdaki komutu çalıştırın:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Linux kullanıyorsanız aşağıdaki komutu çalıştırın:
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Konsol uygulamasını oluşturmak için aşağıdaki komutu çalıştırın:
```
dotnet build
```
Derleme başarıyla tamamlandıktan sonra aşağıdaki komutu çalıştırarak uygulamayı yerel olarak çalıştırın:
```
dotnet run
```

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 Uygulama Yapılandırması sağlayıcısı aracılığıyla bir .NET konsol uygulamasıyla kullandınız. .NET uygulamanızı yapılandırma ayarlarını dinamik olarak yenilemek üzere yapılandırmayı öğrenmek için sonraki öğreticiye geçin.

Dinamik yapılandırmayı etkinleştirme