Hızlı Başlangıç: .NET/.NET Framework konsol uygulamasına özellik bayrakları ekleme

Bu hızlı başlangıçta, özellik yönetiminin uçtan uca uygulamasını oluşturmak için Azure Uygulama Yapılandırmasını bir .NET veya .NET Framework konsol uygulamasına dahil edersiniz. tüm özellik bayraklarınızı merkezi olarak depolamak ve durumlarını denetlemek için Uygulama Yapılandırması kullanabilirsiniz.

.NET özellik yönetimi kitaplıkları özellik bayrağı desteği sağlayarak .NET'i genişletir. Bu kitaplıklar .NET yapılandırma sisteminin üzerinde oluşturulur. .NET yapılandırma sağlayıcısı aracılığıyla Uygulama Yapılandırması ile tümleşir.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir tane oluşturun.
• Bir Uygulama Yapılandırma Mağazası, hızlı başlangıçta mağaza oluşturma bölümünde gösterildiği gibi.
• Visual Studio.
• .NET konsol uygulaması için .NET SDK 8.0 veya üzeri.
• .NET Framework konsol uygulaması için .NET Framework 4.7.2 veya üzeri.

Özellik bayrağı ekleme

Uygulama Yapılandırması deposuna Beta adlı bir özellik bayrağı ekleyin ve Etiket ve Açıklama değerlerini varsayılan değerleriyle bırakın. Azure portalını veya Azure CLI'yı kullanarak bir depoya özellik bayrakları ekleme hakkında daha fazla bilgi için bkz. Özellik bayrağı oluşturma.

Erişim ayarlarını yapılandırma

Bu hızlı başlangıçta oluşturduğunuz uygulama, özellik bayrağı ayarlarınıza erişmek için Uygulama Yapılandırma deponuza bağlanır. Uygulama Yapılandırması'na bağlanmak için uygulamanız Microsoft Entra Id veya bir bağlantı dizesi kullanabilir. Önerilen yaklaşım Microsoft Entra ID'dir.

Microsoft Entra Id (önerilen)

Uygulama Konfigürasyonu veri rolünü atama

Varsayılan olarak, oluşturduğunuz uygulama Uygulama Yapılandırma deponuzda kimlik doğrulaması yapmak için kullanır DefaultAzureCredential . DefaultAzureCredential bir belirteç bilgileri zinciridir. Yetkilendirmenin çalışması için, uygulamanızın kullandığı kimlik bilgilerine Uygulama Yapılandırma Veri Okuyucusu rolü vermeniz gerekir. Yönergeler için bkz. Belirteç kimlik bilgileriyle kimlik doğrulaması. Uygulamanızı çalıştırmadan önce rol atamasının yayılması için yeterli süre tanıyın.

Ortam değişkeni ayarlama

Uygulamanız, Uygulama Yapılandırması ile bağlantı kurmak için bir ortam değişkeni kullanır. Adlı ortam değişkenini Endpoint Uygulama Yapılandırma deponuzun uç noktasına ayarlamak için aşağıdaki komutlardan birini kullanın.

• Komut İstemi'ni kullanıyorsanız aşağıdaki komutu çalıştırın:

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

  Değişikliğin etkili olması için Komut İstemi'ni kapatın ve yeniden açın. Değerini konsola yazdırarak ortam değişkeninin ayarlandığını doğrulayın.

• Windows PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

  [System.Environment]::SetEnvironmentVariable("Endpoint", "<endpoint-of-your-app-configuration-store>", "User")
  

Bağlantı dizesi

Uygulamanız, Uygulama Yapılandırması ile bağlantı kurmak için bir ortam değişkeni kullanır. Adlı ortam değişkenini ConnectionString Uygulama Yapılandırma deponuzun bağlantı dizesine ayarlamak için aşağıdaki komutlardan birini kullanın.

• Komut İstemi'ni kullanıyorsanız 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 İstemi'ni kapatın ve yeniden açın. Değerini konsola yazdırarak ortam değişkeninin ayarlandığını doğrulayın.

• Windows PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

  [System.Environment]::SetEnvironmentVariable("ConnectionString", "<connection-string-of-your-app-configuration-store>", "User")
  

Konsol uygulaması oluşturma

Visual Studio'yu kullanarak yeni bir konsol uygulaması projesi oluşturmak için aşağıdaki adımları uygulayın.

1. Visual Studio'yu açın. Zaten çalışıyorsa, önceki bölümde ayarladığınız ortam değişkenini tanıyabilmesi için kapatın ve yeniden açın.

2. Visual Studio'da Dosya>Yeni Proje'yi> seçin.

3. Yeni proje oluştur iletişim kutusunda, arama kutusuna Konsol yazın.

   • Bir .NET uygulaması oluşturmak istiyorsanız Konsol Uygulaması'na ve ardından İleri'ye tıklayın.
   • Bir .NET Framework uygulaması oluşturmak istiyorsanız Konsol Uygulaması (.NET Framework) öğesini ve ardından İleri'yi seçin.

4. Yeni projenizi yapılandırın iletişim kutusunda bir proje adı girin.

   • Bir .NET uygulaması oluşturmak istiyorsanız , İleri'yi seçerek Ek bilgiler iletişim kutusunu açın. Bu iletişim kutusunda bir .NET çerçevesi seçin, Üst düzey deyimleri kullanma onay kutusunu temizleyin ve oluştur'u seçin.
   • Bir .NET Framework uygulaması oluşturmak istiyorsanız, Framework'ün altında .NET Framework 4.7.2 veya sonraki bir sürümü seçin ve ardından Oluştur'u seçin.

Özellik bayrağını kullanma

Uygulamanızda özellik bayrağını kullanmak için aşağıdaki adımları izleyin.

1. Çözüm Gezgini'nde projenize sağ tıklayın ve ardından NuGet Paketlerini Yönet'i seçin.

2. Gözat sekmesinde aşağıdaki NuGet paketlerinin en son kararlı sürümlerini arayın ve projenize ekleyin:

   Microsoft Entra Id (önerilen)

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement
   • Azure.Identity

   Bağlantı dizesi

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement

3. Program.cs açın ve dosyanın başına aşağıdaki deyimleri ekleyin.

   Microsoft Entra Id (önerilen)

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Microsoft.FeatureManagement;
   using Azure.Identity;
   

   Bağlantı dizesi

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

4. Aşağıdaki kod bloklarında gösterildiği gibi, üç değişiklik yaparak Program.cs güncelleştirin:

   • Uygulama Yapılandırması'ndan özellik bayraklarını yüklemek için yöntemine UseFeatureFlags bir çağrı ekleyin.
   • Yapılandırmadan özellik bayraklarını okumak için bir örneği FeatureManageroluşturun.
   • Beta özellik ayarı etkinse bir ileti görüntüleyin.
   Microsoft Entra Id (önerilen)

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           string endpoint = Environment.GetEnvironmentVariable("Endpoint");
           options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                  .UseFeatureFlags();
       }).Build();
   
   var featureManager = new FeatureManager(
       new ConfigurationFeatureDefinitionProvider(configuration));
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               string endpoint = Environment.GetEnvironmentVariable("Endpoint");
               options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

   Bağlantı dizesi

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                  .UseFeatureFlags();
       }).Build();
   
   var featureManager = new FeatureManager(
       new ConfigurationFeatureDefinitionProvider(configuration));
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

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

1. Visual Studio'da, uygulamayı derlemekve çalıştırmak için Ctrl +F5'i seçin. Konsolda aşağıdaki çıkış görünmelidir.

   

2. Azure Portal’ında oturum açın. Tüm kaynaklar'ı ve ardından Uygulama Yapılandırma deponuzu seçin.

3. Özellik yöneticisi'ni seçin ve Beta özellik bayrağını bulun. Bayrağı etkinleştirmek için Etkin anahtarını açın.

4. Uygulamayı yeniden çalıştırın. Beta iletisi konsolunda görünmelidir.

   

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.

1. Azure portalında oturum açın ve Kaynak grupları'nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Genel bir bakış görmek için sonuç listesinde 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, Uygulama Yapılandırması'de bir özellik bayrağı oluşturdunuz ve bunu bir konsol uygulamasıyla kullandınız. Uygulamayı yeniden başlatmadan özellik bayraklarını ve diğer yapılandırma değerlerini dinamik olarak güncelleştirme hakkında bilgi edinmek için aşağıdaki öğreticilere bakın:

.NET uygulamasında dinamik yapılandırma kullanma

.NET Framework uygulamasında dinamik yapılandırma kullanma

Diğer uygulama türleri için özellik yönetimi özelliğini etkinleştirmek için aşağıdaki hızlı başlangıçlara bakın:

ASP.NET Core uygulamasına özellik bayrakları ekleme

.NET arka plan hizmetine özellik bayrakları ekleme

.NET özellik yönetim kitaplığının tam özellik açıklaması için aşağıdaki belgeye bakın.

.NET özellik yönetimi