如何在C#中将URL中CSV格式数字列表绑定到控制器属性？

你的场景是要把URL中ids=1,2,3这种逗号分隔的CSV值绑定到List<int>类型的属性，但默认的[BindProperty(SupportsGet=true)]无法识别这种格式，导致属性值无效。可以通过以下几种方式解决：

方法一：自定义类型转换器（全局生效） #

添加通用的逗号分隔集合转换器，让框架自动将字符串转为List<T>：

1. 实现转换器类：

public class CommaSeparatedListConverter<T> : TypeConverter where T : struct
{
    public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
    {
        return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
    }

    public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
    {
        if (value is string str)
        {
            return string.IsNullOrEmpty(str) 
                ? new List<T>() 
                : str.Split(',')
                    .Select(s => (T)Convert.ChangeType(s.Trim(), typeof(T), culture))
                    .ToList();
        }
        return base.ConvertFrom(context, culture, value);
    }
}

2. 在Program.cs中注册转换器：

builder.Services.AddControllersWithViews();

// 注册int列表的逗号分隔转换器
TypeDescriptor.AddAttributes(typeof(List<int>), new TypeConverterAttribute(typeof(CommaSeparatedListConverter<int>)));

之后你的原有代码就能正常绑定：

public class CompareController : Controller 
{ 
    [BindProperty(SupportsGet=true)]
    public List<int> Ids { get; set; } 
}

方法二：自定义模型绑定器（针对单个属性） #

如果只需要在特定属性上支持CSV绑定，可以写专属的模型绑定器：

1. 实现模型绑定器：

public class CommaSeparatedIntListBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
        var value = valueProviderResult.FirstValue;

        if (string.IsNullOrEmpty(value))
        {
            bindingContext.Result = ModelBindingResult.Success(new List<int>());
            return Task.CompletedTask;
        }

        try
        {
            var idList = value.Split(',')
                .Select(s => int.Parse(s.Trim(), CultureInfo.InvariantCulture))
                .ToList();
            bindingContext.Result = ModelBindingResult.Success(idList);
        }
        catch (FormatException)
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "ids参数应为逗号分隔的整数列表");
        }

        return Task.CompletedTask;
    }
}

2. 在属性上绑定该模型绑定器：

public class CompareController : Controller 
{ 
    [BindProperty(SupportsGet=true)]
    [ModelBinder(BinderType = typeof(CommaSeparatedIntListBinder))]
    public List<int> Ids { get; set; } 
}

方法三：手动解析（快速临时方案） #

如果不想做全局配置或自定义绑定，也可以在Action中手动获取参数并解析：

public IActionResult Data(string entityType, [FromQuery] string ids)
{
    List<int> idList = new();
    if (!string.IsNullOrEmpty(ids))
    {
        idList = ids.Split(',')
            .Select(s => int.Parse(s.Trim()))
            .ToList();
    }
    // 后续业务逻辑
    return Ok();
}

说明 #

默认情况下，ASP.NET Core的模型绑定器优先识别ids=1&ids=2&ids=3这种多参数格式的集合，不会自动处理逗号分隔的单参数CSV值，因此需要通过上述方式扩展绑定能力。

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