.Net WebApi 添加Swagger

2021-07-12 12:08

阅读：561

标签：name space alc script 属性 main oid 类型 lte

前言

随着互联网技术的发展，现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，而且前端技术和后端技术在各自的道路上越走越远。
前端和后端的唯一联系，变成了API接口；API文档变成了前后端开发人员联系的纽带，变得越来越重要，swagger就是一款让你更好的书写API文档的框架。

安装

首先，创建WebApi类型的项目 TestSwagger

技术分享图片

2. 安装Swashbuckle 包和swagger.Net.UI包

技术分享图片

　　3. 安装完成之后，可以看到这些类与文件都是安装完成时swagger添加的

技术分享图片

设置

设置输出xml文档文件

右键项目属性—>生成—>勾选XML文档文件

技术分享图片

运行

技术分享图片

发生上述错误，请在，SwaggerNet.cs中，注释类上面的两行

技术分享图片

结果又报以下错误：

技术分享图片

这时需要在SwaggerConfig.cs 文件中 GlobalConfiguration.Configuration.EnableSwagger 添加c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());

需要添加注释则加： c.IncludeXmlComments(string.Format("{0}/bin/TestService.XML", System.AppDomain.CurrentDomain.BaseDirectory));

需要在Swagger页面添加自定义header：

需要在SwaggerConfig.cs 文件中 c.OperationFilter();

增加新类：

namespace TestService.App_Start
{
    public class AddAuthorizationHeaderParameterOperationFilter : IOperationFilter
    {
        public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
        {

            if (operation.parameters == null)
            {
                operation.parameters = new List();
            }
            operation.parameters.Add(new Parameter
                {
                    name = "UserId",
                    @in = "header",
                    description = "User short name",
                    required = true,
                    type = "string"
                });

            operation.parameters.Add(new Parameter
            {
                name = "ClientId",
                @in = "header",
                description = "Client generated unique number",
                required = true,
                type = "string"
            });
        }
    }
}

　　显示效果

技术分享图片

.Net WebApi 添加Swagger

标签：name space alc script 属性 main oid 类型 lte

原文地址：https://www.cnblogs.com/suidouya/p/9602492.html

上一篇：Zookeeper系列三：Zookeeper客户端的使用（Zookeeper原生API如何进行调用、ZKClient、Curator）

下一篇：C# 自定义异常的总结

文章来自：搜素材网的编程语言模块，转载请注明文章出处。
文章标题：.Net WebApi 添加Swagger
文章链接：http://soscw.com/index.php/essay/104159.html

亲，登录后才可以留言！

.Net WebApi 添加Swagger

前言

安装

设置

运行

评论

热门文章

推荐文章

最新文章

置顶文章