c# webapi结合swagger的使用

一、使用nuget下载swagger包

     Install-Package Swashbuckle

 

二、配置swagger

    1. 安装完Swashbuckle后，nuget会将相关引用添加至WebApi项目，其中会在App_Start文件夹下添加一个SwaggerConfig.cs文件，如下图所示：
     

 

   2. 设置WebApi生成时，顺便生成一份xml文档信息，用于swagger使用

   

 

  3. 配置swagger引用项目类库生成的xml文档，在SwaggerConfig.cs文件里面进行配置

 

 

 

 

  4. 汉化swaggerui

'use strict';

/** 
 * Translator for documentation pages. 
 * 
 * To enable translation you should include one of language-files in your index.html 
 * after <script src='lang/translator.js' type='text/javascript'></script>. 
 * For example - <script src='lang/ru.js' type='text/javascript'></script> 
 * 
 * If you wish to translate some new texsts you should do two things: 
 * 1. Add a new phrase pair ("New Phrase": "New Translation") into your language file (for example lang/ru.js). It will be great if you add it in other language files too. 
 * 2. Mark that text it templates this way <anyHtmlTag data-sw-translate>New Phrase</anyHtmlTag> or <anyHtmlTag data-sw-translate value='New Phrase'/>. 
 * The main thing here is attribute data-sw-translate. Only inner html, title-attribute and value-attribute are going to translate. 
 * 
 */
window.SwaggerTranslator = {
    _words: [],

    translate: function () {