[ProducesResponseType]`标记接口的返回信息；swagger也能通过接口的参数列表，自动获得发送的数据结构信息。 不过有一个例外，就是上传文件的时候，设置了[Consumes]的内容为`multi-part/form-data`，但是swagger并不能正常感知是上传文件的。代码是这个样子的： > 关于文件上传的细节，可以看多年前我写过一篇有关[通过WEBAPI上传文件的文章](https://www.cnblogs.com/podolski/p/7795168.html)。 ```c# [Consumes("multipart/form-data")] [ODataRoute] [HttpPost] public async Task Post(IFormCollection collection) { var file = collection.Files[0]; if(file != null) { var filename = DateTime.Now.ToString("yyyyMMddHHmmss") + file.FileName; var path =
Path.Combine(_webHostEnvironment.WebRootPath, "Files", filename); using FileStream fileStream = new FileStream(path, FileMode.Create); await file.CopyToAsync(fileStream); var uri = "Files/" + filename; var fileEntity = new Models.File { Url = uri, LastModified = DateTime.Now }; _homeworkDataContext.Files.Add(fileEntity); await _homeworkDataContext.SaveChangesAsync(); return Created(WebUtility.UrlEncode(uri), fileEntity); } return BadRequest(); } ``` 实际上，swagger一直提示，上传的内容是一个array类型，当然API是没有问题的，可以通过POSTMAN进行发送，不过不能在网页上直接操作，总觉得心里有点不太舒服。 ![]