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

  • Makale

Bu hızlı başlangıçta, özellik yönetiminin uçtan uca uygulamasını oluşturmak için Azure Uygulaması Yapılandırmasını bir .NET 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ı, çerçeveyi özellik bayrağı desteğiyle 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

Ö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 CLI'yı kullanarak bir depoya özellik bayrakları ekleme hakkında daha fazla bilgi için Özellik bayrağı oluşturma bölümüne gidin.

Beta adlı özellik bayrağını etkinleştir

Konsol uygulaması oluşturma

Visual Studio'yu kullanarak yeni bir konsol uygulaması projesi oluşturabilirsiniz.

  1. Visual Studio'yu başlatın ve Dosya Yeni Proje'yi> seçin.>

  2. Yeni proje oluştur bölümünde Konsol proje türüne filtreleyin ve Konsol Uygulaması'nı seçin. Bir .NET Framework uygulaması oluşturmak istiyorsanız lütfen bunun yerine Konsol Uygulaması (.NET Framework) öğesini seçin. İleri'ye tıklayın.

  3. Yeni projenizi yapılandırın bölümüne bir proje adı girin. Bir .NET Framework uygulaması oluşturuyorsanız, lütfen Framework altında .NET Framework 4.7.2 veya üzerini seçin. Oluştur’a tıklayın.

Özellik bayrağını kullanma

  1. 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.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement

    sürümünün Microsoft.FeatureManagement 3.1.0'dan büyük olduğundan emin olun.

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

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

  3. Özellik bayraklarının alınması için seçeneğini belirterek UseFeatureFlags Uygulama Yapılandırması bağlanın. Yapılandırmadan özellik bayrağı tanımı sağlamak için ve ConfigurationFeatureDefinitionProvider özellik bayraklarının durumunu değerlendirmek için bir FeatureManager oluşturun. Ardından özellik bayrağı etkinse Beta bir ileti görüntüleyin.

    IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
            .UseFeatureFlags();
    }).Build();

IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

IFeatureManager featureManager = new FeatureManager(
    featureDefinitionProvider, 
    new FeatureManagementOptions());

if (await featureManager.IsEnabledAsync("Beta"))
{
    Console.WriteLine("Welcome to the beta!");
}

Console.WriteLine("Hello World!");

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

  1. ConnectionString adlı bir ortam değişkenini Uygulama Yapılandırması deponuzun 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"

    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.

  2. Değişikliğin etkili olması için Visual Studio'yu yeniden başlatın.

  3. Uygulamayı derlemek ve çalıştırmak için Ctrl + F5 tuşlarına basın.

  4. Konsolda aşağıdaki çıkışları görmeniz gerekir.

    Özellik bayrağı devre dışı olan uygulama

  5. Azure Portal’ında oturum açın. Tüm kaynaklar'ı seçin ve daha önce oluşturduğunuz Uygulama Yapılandırması depoyu seçin.

  6. Özellik yöneticisi'ni seçin ve Beta özellik bayrağını bulun. Etkin altındaki onay kutusunu seçerek bayrağı etkinleştirin.

  7. Uygulamayı yeniden çalıştırın. Konsolunda Beta iletisini görmeniz gerekir.

    Özellik bayrağı etkinleştirilmiş uygulama

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 sonraki öğreticiye geçin.

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

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

Diğer uygulama türleri için özellik yönetimi özelliğini etkinleştirmek için aşağıdaki öğreticilere geçin.

ASP.NET Core uygulamalarında özellik bayraklarını kullanma

.NET arka plan hizmetlerinde özellik bayraklarını kullanma

.NET özellik yönetimi kitaplığının tam özellik çalıştırması için aşağıdaki belgeye geçin.

.NET Özellik Yönetimi