c# - 最小化时不显示文档注释

标签 c# vb.net comments xml-documentation

当用 C# 编写 XML 注释时,它看起来如下所示,但是当您最小化它时,您看到的只是摘要标题,而不是您实际键入的摘要。在 VB.Net 中,它按照我期望的方式工作,并在最小化时显示评论文本。有什么方法可以通过扩展或其他方式调整此行为?

常规

    /// <summary>
    ///     Some Comment
    /// </summary>
    public int MyProperty { get; set; }

最小化

    |/// <summary> ...|
    public int MyProperty { get; set; }

理想最小化

    | Some Comment |
    public int MyProperty { get; set; }

更新。这是来自 VB.Net 的示例。我不敢相信我会这么说,但如果 C# 也能以同样的方式工作那就太好了。

常规

    ''' <summary>
    ''' Some Comment
    ''' </summary>
    ''' <remarks></remarks>
    Sub Main()

    End Sub

最小化

    |Some Comment|
    Sub Main()

    End Sub

最佳答案

Visual Studio 始终折叠到 block 中文本的第一行,无论它是什么。如果您想在折叠 XML 注释时查看摘要,则必须将其放在第一行,如下行:

/// <summary>Some Comment</summary>
/// <remarks>
/// </remarks>
public int MyProperty { get; set; }

折叠到

/// <summary>Some Comment</summary> ...
public int MyProperty { get; set; }

关于c# - 最小化时不显示文档注释,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/25296833/

相关文章:

c# - ASP.NET 核心 : Error when using a custom DbContext while also using Identity

c# - Lucene 自定义分析器

c# - 使用反射执行审计

objective-c - 在 Xcode 中创建 "Quick Help"条目

asp.net - 我可以在 ASP.NET 中的标签内放置评论吗?

clojure - Clojure 中的多行 shebang?

c# - 报表查看器 IE 11

c# - 处理日期差异

.net - 如何从子表单触发父表单事件?

vb.net - 执行读取器 : CommandText property has not been initialized when trying to make a register form for my database