net swagger只显示接口注释,不显示实体注释

原因是你将实体类放到不同的项目中了,如果不指定位置,swagger无法加载注释。

在下面这段代码中,xmlFilename 指向api的xml,xmlModels 指向实体类的xml,这里注意:实体类也要输出xml

复制代码
    builder.Services.AddSwaggerGen(options =>
    {
        options.SwaggerDoc("v1", new OpenApiInfo
        {
            Version = "v1",
            Title = "API标题",
            Description = "API描述"
        });
        var xmlFilename = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
        options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlFilename));

        //增加实体库的引用,否则无法显示实体注释
        var xmlModels = $"{Assembly.Load("CatalogService.Domain").GetName().Name}.xml";
        options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, xmlModels));
    });
复制代码

 

posted @   土豆365  阅读(628)  评论(0编辑  收藏  举报
相关博文:
阅读排行:
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期(2025年3.1-3.9)
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异
点击右上角即可分享
微信分享提示