在 ASP.NET Core 应用程序中启用使用自定义筛选器的条件功能

项目
12/20/2024

功能标志可以使用功能筛选器有条件地启用功能。若要了解有关功能筛选器的详细信息，请参阅通过功能筛选器启用条件功能。

本指南中使用的示例基于功能管理快速入门中介绍的 ASP.NET Core 应用程序。在继续学习之前，请完成快速入门，创建具有 Beta 功能标志的 ASP.NET Core 应用程序。完成后，必须将自定义功能筛选器添加到你的应用程序配置存储中的 Beta 功能标志。

在本指南中，你将了解如何实现自定义功能筛选器，并使用功能筛选器有条件地启用功能。

先决条件

实现自定义功能筛选器

你已在先决条件中添加了一个名为 Random 的自定义功能筛选器，其中包含你的 Beta 功能标志的 Percentage 参数。接下来，你将实现功能筛选器，根据 Percentage 参数定义的几率启用 Beta 功能标志。

使用以下代码添加 RandomFilter.cs 文件。

using Microsoft.FeatureManagement;

namespace TestAppConfig
{
    [FilterAlias("Random")]
    public class RandomFilter : IFeatureFilter
    {
        private readonly Random _random;

        public RandomFilter()
        {
            _random = new Random();
        }

        public Task<bool> EvaluateAsync(FeatureFilterEvaluationContext context)
        {
            int percentage = context.Parameters.GetSection("Percentage").Get<int>();

            int randomNumber = _random.Next(100);

            return Task.FromResult(randomNumber <= percentage);
        }
    }
}

你添加了一个从 Microsoft.FeatureManagement 库实现 IFeatureFilter 接口的 RandomFilter 类。 IFeatureFilter 接口具有一个方法，名为 EvaluateAsync，每当评估功能标志时都会调用它。在 EvaluateAsync 中，功能筛选器通过返回 true 来启用功能标志。

你将 FilterAliasAttribute 装饰到 RandomFilter 上，从而给你的筛选器一个别名 Random，该别名与你在 Azure 应用程序配置中的 Beta 功能标志中设置的筛选器名称相匹配。

打开 Program.cs 文件，并通过调用 AddFeatureFilter 方法注册 RandomFilter。

// The rest of existing code in Program.cs
// ... ...

// Add feature management to the container of services.
builder.Services.AddFeatureManagement()
                .AddFeatureFilter<RandomFilter>();

// The rest of existing code in Program.cs
// ... ...