AspNet Core Swagger4.0 生成请求model描述

今天给大家分享 swagger 俩个冷门的小技巧

获取控制器描述

将 IncludeXmlComments 方法第二个参数设置为 true 即可

public static void IncludeXmlComments(filePath,true)

效果如图

获取请求 model 的描述

这里有两种情况：

a.请求的 model 跟控制器在同一目录下

b.请求的 model 在其它类库下

如果是第二种情况，则需要 model 所在的类库也生成跟控制器目录一样的 xml 描述文件，并且要在 startup 类下的 ConfigureServices 方法中加载此文件。

//请求model所在的程序集
var assembly = Assembly.GetAssembly(typeof(BaseDto));
x.IncludeXmlComments(assembly.Location.Replace("dll", "xml"));

效果如图