c# - Ghostdoc 不会尝试生成返回信息

Question

我注意到 Ghostdoc 似乎从未尝试生成退货文档。给定这样的方法：

/// <summary>
/// Gets the departure date.
/// </summary>
/// <returns></returns>
private DateTime GetDepartureDate()
{
    // TODO:
}

我希望它能够像这样填充退货信息：

/// <summary>
/// Gets the departure date.
/// </summary>
/// <returns>The departure date.</returns>
private DateTime GetDepartureDate()
{
    // TODO:
}

我看过这个，但这已经很老了，老实说，我不太明白。有任何想法吗？

显然它永远不会完美，但有总比没有好。

Answer 1

默认情况下，Ghostdoc 不会尝试为返回类型提供任何文本。但是，您可以按照问题链接中的建议设置规则来执行此操作。

例如，要设置一个规则，将返回描述添加到名称以“Get...”开头的任何方法，并使用方法名称的其余部分作为文本（如问题中所建议的那样）：

1. 在 Visual Studio 中，转到工具 > Ghostdoc > 选项
2. 在Rules树下选择GhostDoc
3. Methods在右侧规则列表中选择“文件夹”（您可能需要滚动列表）

添加新规则以匹配以“Get...”开头的方法：

4. 单击Add...并OK添加新的“自定义匹配”规则
5. 将名称更改为：

   匹配“获取”方法

6. 点击<any>后面的链接method name设置条件

7. 选择starts with，输入

   得到

   后跟一个空格，在文本框中并单击OK

现在，设置“返回”模板文本：

8. 在网格中，单击...旁边的省略号按钮<returns>

9. 类型

   这

   后跟一个空格，在“模板文本”框中

10. 展开MethodName> Words，选择ExceptFirst，单击Insert并OK

默认摘要文本被新规则覆盖，因此为我们的新规则添加一些有意义的内容：

11. 回到网格中，单击...旁边的按钮<summary>

12. 类型

    获取

    后跟一个空格，在模板文本框中

13. 展开MethodName> Words，选择ExceptFirst，单击Insert并OK
14. 点击OK完成规则设置

确保规则位于现有规则的下方，int GetHashCode()以便在该特殊情况下后者优先。单击“确定”关闭“选项”对话框，您就可以尝试新规则了。