表单集合处理

2026/4/22小于 1 分钟

表单集合处理

按照 OpenApi，一个集合在 Uri 的 Query 或表单中支持 5 种表述方式：

格式	说明
Csv	逗号分隔
Ssv	空格分隔
Tsv	反斜杠分隔
Pipes	竖线分隔
Multi	多个同名键的键值对

示例

对于 id = ["001","002"] 这样的数组值，在 PathQueryAttribute 与 FormContentAttribute 处理后分别是：

CollectionFormat	Data
`[PathQuery(CollectionFormat = CollectionFormat.Csv)]`	`id=001,002`
`[PathQuery(CollectionFormat = CollectionFormat.Ssv)]`	`id=001 002`
`[PathQuery(CollectionFormat = CollectionFormat.Tsv)]`	`id=001\002`
`[PathQuery(CollectionFormat = CollectionFormat.Pipes)]`	`id=001\|002`
`[PathQuery(CollectionFormat = CollectionFormat.Multi)]`	`id=001&id=002`

使用示例

public interface IUserApi
{
    [HttpGet("api/users")]
    Task<List<User>> GetAsync(
        [PathQuery(CollectionFormat = CollectionFormat.Multi)] int[] ids);
}

请求结果：api/users?ids=1&ids=2&ids=3