### 如何在 Swagger 中添加 FormData 支持 为了使 API 文档能够通过 Swagger 正确展示 `multipart/form-data` 类型的支持，需要确保几个方面都得到妥善处理。 API 方法应被定义为接受 `IFormFile` 或者 `[FromForm]` 参数来接收表单数据[^1]。下面是一个 C# Web API 控制器方法的例子： ```csharp [HttpPost("upload")] public async Task<IActionResult> Upload([FromForm] IFormFile file) { if (file == null || file.Length == 0) return BadRequest("No file uploaded."); // Process the file... return Ok(); } ``` 对于 Swagger 配置部分，在 `Startup.cs` 文件中的配置服务里加入如下设置可以启用文件上传功能并让其显示于 UI 上： ```csharp services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" }); // Add this line to enable formData parameter support in Swagger UI. c.OperationFilter<AddFormDataSupport>(); }); ``` 还需要创建一个操作过滤器用于增强 Swagger 的元数据描述能力，以便更好地表示多部件请求体参数: ```csharp using Microsoft.OpenApi.Models; using Swashbuckle.AspNetCore.SwaggerGen; public class AddFormDataSupport : IOperationFilter { public void Apply(OpenApiOperation operation, OperationFilterContext context) { var parameters = operation.Parameters ?? Enumerable.Empty<OpenApiParameter>(); foreach (var param in parameters.Where(p => p.In == ParameterLocation.FormData)) { operation.RequestBody = new OpenApiRequestBody() { Content = { ["multipart/form-data"] = new OpenApiMediaType() { Schema = new OpenApiSchema() { Type = "string", Format = "binary"} } }, Required = true, }; break; // Only one multipart/form-data request body is allowed per operation. } operation.Parameters = parameters.ToList(); } } ``` 上述代码片段展示了如何修改现有的 ASP.NET Core 应用程序以支持通过 Swagger 显示和测试带有 `form-data` 请求体的端点。