要解决ASP .NET Boilerplate控制器的Swagger XML文档不可见的问题,你需要执行以下步骤:
services.AddSwaggerGen(c =>
{
// ...其他配置
var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
c.IncludeXmlComments(xmlPath);
});
确保XML文档生成选项已启用。在项目的属性面板中,找到生成选项,并确保启用了XML文档生成。选择“生成解决方案”后,将生成XML文档。
检查生成的XML文档是否位于正确的位置。在生成后,确认XML文件是否位于生成输出目录的根目录下,文件名与上述代码中的文件名一致。
如果你使用了IIS托管你的应用程序,请确保应用程序的IIS应用程序池中启用了“启用32位应用程序”选项。这是因为Swagger使用了一些COM组件,这些组件需要在32位模式下运行。
通过执行以上步骤,你应该能够解决ASP .NET Boilerplate控制器的Swagger XML文档不可见的问题,并在Swagger UI中看到API文档。