这篇文章主要介绍“如何使用最小WEBAPI实现文件上传”的相关知识，小编通过实际案例向大家展示操作过程，操作方法简单快捷，实用性强，希望这篇“如何使用最小WEBAPI实现文件上传”文章能帮助大家解决问题。

前言：

我们使用最小 WEB API 实现文件上传功能，虽然客户端访问是正常的，但是当打开 Swagger 页面时，发现是这样的：

没法使用 Swagger 页面测试。

一、允许 Content Type

正常的 Swagger 页面应该是这样的：

看来，我们需要指定 Content Type：

app.MapPost("/upload",async(HttpRequestrequest)=>{varform=awaitrequest.ReadFormAsync();returnResults.Ok(form.Files.First().FileName);}).Accepts<HttpRequest>("multipart/form-data");

结果，Swagger 页面变成了这样，增加了一堆 Form 相关属性，唯独没有 file :

看来，只有自定义 Swagger 页面了。

二、自定义 OperationFilter

在 OpenAPI 3.0 中，文件上传的请求可以用下列结构描述：

而在 Swashbuckle 中，可以使用 IOperationFilter 接口实现操作筛选器，控制如何定义 Swagger UI 的行为。

在这里，我们将利用 RequestBody 对象来实现上述的文件上传的请求结构。

publicclassFileUploadOperationFilter:IOperationFilter{publicvoidApply(OpenApiOperationoperation,OperationFilterContextcontext){conststringFileUploadContentType="multipart/form-data";if(operation.RequestBody==null||!operation.RequestBody.Content.Any(x=>x.Key.Equals(FileUploadContentType,StringComparison.InvariantCultureIgnoreCase))){return;}if(context.ApiDescription.ParameterDescriptions[0].Type==typeof(HttpRequest)){operation.RequestBody=newOpenApiRequestBody{Description="MyIO",Content=newDictionary<String,OpenApiMediaType>{{FileUploadContentType,newOpenApiMediaType{Schema=newOpenApiSchema{Type="object",Required=newHashSet<String>{"file"},Properties=newDictionary<String,OpenApiSchema>{{"file",newOpenApiSchema(){Type="string",Format="binary"}}}}}}}};}}}

然后，在启动代码中配置，应用此操作筛选器：

builder.Services.AddSwaggerGen(setup=>{setup.OperationFilter<FileUploadOperationFilter>();});

这将呈现如下 Swagger 页面：

关于“如何使用最小WEBAPI实现文件上传”的内容就介绍到这里了，感谢大家的阅读。如果想了解更多行业相关的知识，可以关注亿速云行业资讯频道，小编每天都会为大家更新不同的知识点。