.net 配置swagger

第一步：

在nuget.org中查找Swashbuckle並下載

 

 

 

 

在nuget.org中查找Swagger.net.UI，並下載

 

 

       

第二步：

下載完之后，App_Start多了三個文件

Swagger.Auth.cs

SwaggerConfig.cs

SwaggerNet.cs

將SwaggerNet.cs刪除，沒用的cs文件

 

 

 

 

 

第三步：

配置：SwaggerConfig.cs

將

c.IncludeXmlComments(string.Format("{0}/bin/SwaggerDemo.XML", System.AppDomain.CurrentDomain.BaseDirectory));

 

放在 GlobalConfiguration.Configuration

                .EnableSwagger(c =>

                    {}

當中

 

 

 

 

第四步：

點擊項目下的小扳手

找到生成中的輸出，勾選XML文檔文件，將文件名改為與上一步當中的XML文件名一致

 

 

將禁止顯示警告設為1591，不然會警告沒有設置XML文檔注釋，保存即可

 

 

成果顯示：默認的路徑就是http://localhost:56708/swagger(api路徑/swagger)

 

 

最后一步

只需加上注釋即可

注意：注釋必須使用文檔注釋，///

 

 

 

可以直接測試數據,s輸入ID,點擊Try it out

 

 

 

最終效果