微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

代码文档,从常量中获取值

如何解决代码文档,从常量中获取值

有没有可能,有一个常数

 public const string MyString = "myValue"

在 xml 注释中获取它的值“myValue”?我对生成 swagger 文档很感兴趣。

    /// <summary>
    /// Creates a new resource.
    /// </summary>
    /// <param name="request">The request object.</param>
    /// <returns code="200">The id of the new resource.</returns>
    /// <response code="400">
    /// <see cref="Errors.BadRequestCodes.MyString"/><para/>
    /// </response>

这是一个记录端点的示例。在 swagger ui 中,我实际上看到的是“Errors.BadRequestCodes.MyString”,而不是在 400 状态代码部分看到消息“myValue”。有没有办法实现这一点?

解决方法

您是否尝试过使用 <inheritdoc>,并在第一个文件中添加 const 值,然后在第二个文件中引用它?

https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/inheritdoc

Rendering constants into XML documentation?

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。