xml-comments - GhostDoc“记录此”不适用于具有属性的方法

Question

我正在使用 GhostDoc 和 Visual Studio 2017。

现在，如果我有这样的方法

public string Foo() { ... }

我通常可以使用 GhostDocs“记录这个”来为相关方法生成 XML 注释。

但是，如果该方法应用了任何属性，例如

[NotNull]
public string Foo() { ... }

GhostDoc无法自动记录该方法。这是为什么？由于我的所有方法都已注释，因此无法使用 GhostDoc 并不是很舒服。

顺便说一句：我尝试通过在属性和方法/// 之间插入来手动添加注释，这会产生

XML 注释未放在有效的语言元素上

错误。

但是，如果我在属性/// 之前插入，我不会收到错误消息。我觉得即使在方法和属性/// 之间添加注释，注释也会应用于方法，因此应该放在有效的语言元素上，不是吗？

score 1 · Accepted Answer

来自 SubMain 的 Serge 来了。

我们试图重现您报告的问题，GhostDoc 生成的文档很好。

您能否将 GhostDoc 日志文件发送给我们以进行故障排除？您将在 \SubMain\GhostDoc {Edition} 中找到 Vsxxx*.log 的日志文件

请在 submain dot com 的支持处发送日志。

如果您包括生产版本和版本，那将非常有帮助。

我们期待与您一起解决您遇到的问题！

谢谢！

1 回答 1