如何添加鼠标悬停摘要

Question

我几乎可以肯定这将是一个非常简单的答案，但我似乎无法在任何地方找到它。我们都知道，当您将鼠标悬停在某物（例如字符串）上时，会弹出一个小摘要（如果已启用）。对于字符串，它表示：

系统字符串类

将文本表示为一系列 Unicode 字符。

当我将鼠标悬停在我的一个类上时，它只是说：

类命名空间.Widget

我已经尝试了我发现的两个明显的例子：

/// <summary>
/// This summary does not work, I know it's for html documenting tools but thought it was worth a shot.
/// </summary>

和：

// Summary:
//     This is what is in some of the base libraries, and does not work as well.

那么，如何向鼠标悬停弹出窗口添加摘要？

Answer 1

我不明白为什么你的第一次尝试不起作用。这是

评论标签，它提供了您正在谈论的“工具提示”...

/// <summary>
/// This text should automatically show up as the summary when hovering over
/// an instance of this class in VS
/// </summary>
public class MyClass
{
    public MyClass() {}      
}

public class MyClass2
{
    public MyClass()
    {
        //hovering over 'something' below in VS should provide the summary tooltip...
        MyClass something = new MyClass();
    }
}

如果您需要自动化某些评论的帮助，请尝试免费的 GhostDoc。迄今为止最好的免费 VS 插件之一..

Answer 2

我刚刚发现的两个附加检查将阻止悬停时显示摘要：

不要在您的代码中使用与号 (&) 或起始尖括号 (<)摘要描述。

中断：

    ///<summary>
    ///Class does this & that
    ///</summary>

改为使用：

    ///<summary>
    ///Class does this AND that
    ///</summary>

中断：

    /// <summary>
    /// Checks if this < that
    /// </summary>

这会起作用，但可能不是一个好的先例：

    /// <summary>
    /// Checks if this > that 
    /// </summary>

---

不要将 /// 行彼此分开。

休息：

    /// <summary>
    /// This text will not show
    
    /// </summary>

休息：

    /// <summary>
    /// This text will also not show
    //  because THIS line only has 2 dashes
    /// </summary>

工作：

    /// <summary>
    ///
    /// This
    ///    
    /// is
    ///
    /// fine.
    ///
    /// </summary>

Answer 3

三斜杠 XML 注释可用于在 Visual Studio 中创建 IDE 工具提示。尤其是“总结”和“例外”效果非常好。 （“代码”等其他内容在我使用的 Visual Studio 版本中不起作用。）

如果这对您不起作用，则您的设置可能有问题。

Answer 4

重置 Visual Studio 中的设置，它们似乎混乱了。为了让它显示出来，您必须使用第一个示例。

Answer 5

您需要使用第一个语法，并且，如果您在 Visual Studio 解决方案之外使用该类，则需要在项目属性中选中“生成 XML 文档文件”。

Answer 6

除了上述答案之外，请访问 Microsoft 文档链接，获取完整的标签列表，为您的课程制作非常漂亮的摘要。