包括XML注释- Swashbuckle

Question

Xml注释未显示

我遵循的例子是：https://github.com/domaindrivendev/Swashbuckle

我的代码如下所示：

var baseDirectory = System.String.Format(@"{0}bin\", AppDomain.CurrentDomain.BaseDirectory);
var commentsFileName = Assembly.GetExecutingAssembly().GetName().Name + ".XML";
var commentsFile = Path.Combine(baseDirectory, commentsFileName);
c.SingleApiVersion("v1", "Documentação web Api");

在我的DefaultController里

​

[RoutePrefix("api")]
public class DefaultController : ApiController
{
    /// <summary>
    /// Register a new user on application
    /// </summary>
    /// <param name="user">New user to register</param>
    /// <remarks>Adds new user to application and grant access</remarks>
    /// <response code="400">Bad Request</response>
    /// <response code="500">Internal Server Error</response>

    [HttpGet]
    [Route("consulta/BuscaProduto")]
    //localhost:50907/api/consulta/BuscaProduto
    public HttpResponseMessage BuscaProduto()
    {
        try
        {
            var tTabela = new ProdutoAplicacao();
            var listar = tTabela.ListaTodos();
            return Request.CreateResponse(HttpStatusCode.OK, listar, Configuration.Formatters.JsonFormatter);
        }
        catch (Exception ex)
        {

            return Request.CreateResponse(HttpStatusCode.BadRequest, ex.Message);
        }
    }

}

​

​

Answer 1

最近我一直在努力解决这个问题:)

如果显式指定了任何响应，Swashbuckle将不会自动生成包含模型和示例值的200个成功响应。

在您的示例中，由于您指定了"400“和"500”响应，Swashbuckle希望您也指定"200“响应。我想你有两个选择：

1. 为指定其他响应的每个端点指定XML注释中的200个响应
2. 在Add the 200 responses programmatically中使用操作过滤器的SwaggerConfig