如何让ASP.NET Core将查询字符串中的CSV绑定到字符串列表属性？

方案一：全局注册自定义模型绑定器 #

该方案会让所有List<string>类型的参数绑定自动处理逗号分隔的字符串：

1. 实现自定义模型绑定器逻辑

public class CsvListModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);

        var rawValue = valueProviderResult.FirstValue;
        if (string.IsNullOrWhiteSpace(rawValue))
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        var parsedList = rawValue.Split(',', StringSplitOptions.RemoveEmptyEntries)
                                 .Select(item => item.Trim())
                                 .ToList();

        bindingContext.Result = ModelBindingResult.Success(parsedList);
        return Task.CompletedTask;
    }
}

2. 创建绑定器提供者

public class CsvListModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context == null)
            throw new ArgumentNullException(nameof(context));

        if (context.Metadata.ModelType == typeof(List<string>))
            return new BinderTypeModelBinder(typeof(CsvListModelBinder));

        return null;
    }
}

3. 在Program.cs中注册全局绑定器

builder.Services.AddControllers(options =>
{
    // 插入到绑定器列表最前面，确保优先级高于默认绑定器
    options.ModelBinderProviders.Insert(0, new CsvListModelBinderProvider());
});

方案二：针对单个属性局部绑定 #

如果仅需特定属性支持CSV解析，无需全局注册，直接在属性上标记绑定器：

1. 先实现方案一中的CsvListModelBinder类
2. 在控制器属性上添加ModelBinder特性：

[BindProperty(SupportsGet = true)]
[ModelBinder(BinderType = typeof(CsvListModelBinder))]
public List<string> Brands { get; set; }

进阶处理（含逗号的CSV值） #

如果查询参数值包含逗号（例如brands=bmw,"toyota,camry"），简单的逗号拆分逻辑会失效，可引入CsvHelper库处理标准CSV格式：

修改绑定器中的解析逻辑：

using CsvHelper;
using System.Globalization;

// ...
var parsedList = new List<string>();
using (var reader = new StringReader(rawValue))
using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
    csv.Configuration.HasHeaderRecord = false;
    parsedList = csv.GetRecord<string[]>().ToList();
}
// ...

注意事项 #

• 拆分后调用Trim()去除元素前后空白，避免出现带空格的无效元素
• 全局注册会影响所有List<string>类型的绑定，若有特殊场景需单独处理，建议使用局部绑定方案

内容的提问来源于stack exchange，提问作者AmirMohammad