Megosztás a következőn keresztül:


Rövid útmutató: Funkciójelzők hozzáadása .NET/.NET-keretrendszer konzolalkalmazáshoz

Ebben a rövid útmutatóban Azure-alkalmazás Konfigurációt egy .NET-konzolalkalmazásba építi be a funkciókezelés végpontok közötti implementációjának létrehozásához. Az Alkalmazáskonfigurációval központilag tárolhatja az összes funkciójelzőt, és szabályozhatja azok állapotát.

A .NET szolgáltatásfelügyeleti kódtárak funkciójelző-támogatással bővítik a keretrendszert. Ezek a kódtárak a .NET-konfigurációs rendszerre épülnek. Az alkalmazáskonfigurációval a .NET-konfigurációszolgáltatón keresztül integrálhatók.

Előfeltételek

Funkciójelző hozzáadása

Adjon hozzá egy bétaverzió nevű funkciójelzőt az Alkalmazáskonfigurációs áruházhoz, és hagyja meg a címkét és a leírást az alapértelmezett értékekkel. Ha többet szeretne tudni arról, hogyan adhat hozzá funkciójelzőket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Funkciójelölő létrehozása elemre.

Bétaverzió nevű funkciójelző engedélyezése

Konzolalkalmazás létrehozása

A Visual Studióval létrehozhat egy új konzolalkalmazás-projektet.

  1. Indítsa el a Visual Studiót, és válassza az Új>projekt fájlja>lehetőséget.

  2. Az Új projekt létrehozása területen szűrjön a konzolprojekt típusára, és válassza a Konzolalkalmazás lehetőséget. Ha .NET-keretrendszer alkalmazást szeretne létrehozni, válassza inkább a Konzolalkalmazás (.NET-keretrendszer) lehetőséget. Kattintson a Tovább gombra.

  3. Az új projekt konfigurálásához adjon meg egy projektnevet. Ha .NET-keretrendszer alkalmazást hoz létre, válassza .NET-keretrendszer 4.7.2 vagy újabb verziót a Keretrendszer alatt. Kattintson a Létrehozás gombra.

A funkciójelző használata

  1. Kattintson a jobb gombbal a projektre, és válassza a NuGet-csomagok kezelése lehetőséget. A Tallózás lapon keresse meg és adja hozzá a következő NuGet-csomagokat a projekthez.

    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    

    Győződjön meg arról, hogy a verzió nagyobb Microsoft.FeatureManagement , mint 3.1.0.

  2. Nyissa meg Program.cs , és adja hozzá a következő utasításokat.

    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    
  3. Csatlakozzon az alkalmazáskonfigurációhoz, és adja meg a lehetőséget a UseFeatureFlags funkciójelzők lekéréséhez. Hozzon létre egy ConfigurationFeatureDefinitionProvider funkciót jelző definíciót a konfigurációból, és egy FeatureManager a funkciójelzők állapotának kiértékeléséhez. Ezután jelenítsen meg egy üzenetet, ha a Beta funkciójelző engedélyezve van.

    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!");
    

Az alkalmazás helyi létrehozása és futtatása

  1. Állítson be egy ConnectionString nevű környezeti változót az alkalmazáskonfigurációs áruház kapcsolati sztring.

    Ha a Windows parancssorát használja, futtassa a következő parancsot.

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

    Indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez. A környezeti változó értékének nyomtatásával ellenőrizheti, hogy megfelelően van-e beállítva.

  2. Indítsa újra a Visual Studiót a módosítás érvénybe lépésének engedélyezéséhez.

  3. Az alkalmazás létrehozásához és futtatásához nyomja le a Ctrl + F5 billentyűkombinációt.

  4. A következő kimeneteknek kell megjelennie a konzolon.

    Letiltott funkciójelzővel rendelkező alkalmazás

  5. Jelentkezzen be az Azure Portalra. Válassza a Minden erőforrás lehetőséget, és válassza ki a korábban létrehozott Alkalmazáskonfigurációs áruházat.

  6. Válassza a Funkciókezelőt, és keresse meg a bétafunkció-jelzőt. Engedélyezze a jelölőt az Engedélyezve jelölőnégyzet bejelölésével.

  7. Futtassa ismét az alkalmazást. A bétaüzenetnek a konzolon kell megjelennie.

    Engedélyezve van a funkciójelzővel rendelkező alkalmazás

Az erőforrások eltávolítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

  1. Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
  2. A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
  3. Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
  4. Válassza az Erőforráscsoport törlése elemet.
  5. A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy funkciójelzőt az Alkalmazáskonfigurációban, és egy konzolalkalmazással használta. Ha szeretné megtudni, hogyan frissítheti dinamikusan a funkciójelzőket és más konfigurációs értékeket az alkalmazás újraindítása nélkül, folytassa a következő oktatóanyagban.

Ha más típusú alkalmazások szolgáltatásfelügyeleti funkcióját szeretné engedélyezni, folytassa az alábbi oktatóanyagokkal.

A .NET szolgáltatásfelügyeleti kódtár teljes funkciólefutásához folytassa a következő dokumentumot.