最小化时,文档注释不会显示

时间:2014-08-13 21:53:31

标签: 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

1 个答案:

答案 0 :(得分:2)

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

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

崩溃到

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