asp.net swagger 添加注释

要在 ASP.NET 中使用 Swagger 添加注释，需要使用 XML 注释文件。首先，需要在项目的属性中启用 XML 注释，方法是右键单击项目，选择“属性”，然后在“生成”选项卡下启用“XML 文档文件”。

接下来，在 WebAPI 配置文件中，需要使用以下代码行启用 Swagger：

config.EnableSwagger(c =>
{
    c.SingleApiVersion("v1", "API Name");
    c.IncludeXmlComments(string.Format(@"{0}\bin\{1}.xml", 
        System.AppDomain.CurrentDomain.BaseDirectory, 
        "YourProjectName"));
});

这些代码将启用 Swagger，并将 XML 注释文件包含在 API 文档中。确保设置正确的 XML 注释文件名称和路径，并替换“API Name”和“YourProjectName”为实际的值。

最后，在您的控制器和操作上添加 XML 注释即可。例如，以下是一个操作方法及其注释的示例：

/// <summary>
/// Get all products
/// </summary>
/// <returns>List of products</returns>
public IEnumerable<Product> Get()
{
    return products;
}

使用这些步骤，您可以在 ASP.NET 中轻松添加 Swagger 注释。