GhostDoc "Document this" 不适用于具有属性的方法
GhostDoc "Document this" not working for method with attribute
我正在使用 GhostDoc 和 Visual Studio 2017。
现在,如果我有这样的方法
public string Foo() { ... }
我可以正常使用 GhostDocs "Document this" 为相关方法生成 XML 注释。
但是,如果该方法应用了任何属性,例如
[NotNull]
public string Foo() { ... }
GhostDoc 无法自动 记录该方法。这是为什么?由于几乎所有的方法都有注释,因此无法使用 GhostDoc 不是很舒服。
- GhostDoc 有什么方法可以用属性记录方法吗?
顺便说一下:我尝试通过在属性和方法之间插入///
来手动添加注释,这会产生一个
XML comment is not placed on a valid language element
错误。
但是,如果我在 属性之前插入 ///
,则不会出现错误。我觉得即使在添加 ///
between 方法和属性时,注释也会应用于 method 因此应该放置在有效的语言元素上,不是吗?
SubMain 的 Serge 来了。
我们尝试重现您报告的问题,GhostDoc 生成的文档很好。
能否将 GhostDoc 日志文件发送给我们以进行故障排除?您将在 \SubMain\GhostDoc {Edition} 中找到 VSxxxx*.log
的日志文件
请将日志发送至 submain.com 的支持部门。
如果您包括生产版本和版本,那将非常有帮助。
我们期待与您合作解决您遇到的问题!
谢谢!
我正在使用 GhostDoc 和 Visual Studio 2017。
现在,如果我有这样的方法
public string Foo() { ... }
我可以正常使用 GhostDocs "Document this" 为相关方法生成 XML 注释。
但是,如果该方法应用了任何属性,例如
[NotNull]
public string Foo() { ... }
GhostDoc 无法自动 记录该方法。这是为什么?由于几乎所有的方法都有注释,因此无法使用 GhostDoc 不是很舒服。
- GhostDoc 有什么方法可以用属性记录方法吗?
顺便说一下:我尝试通过在属性和方法之间插入///
来手动添加注释,这会产生一个
XML comment is not placed on a valid language element
错误。
但是,如果我在 属性之前插入 ///
,则不会出现错误。我觉得即使在添加 ///
between 方法和属性时,注释也会应用于 method 因此应该放置在有效的语言元素上,不是吗?
SubMain 的 Serge 来了。
我们尝试重现您报告的问题,GhostDoc 生成的文档很好。
能否将 GhostDoc 日志文件发送给我们以进行故障排除?您将在 \SubMain\GhostDoc {Edition} 中找到 VSxxxx*.log
的日志文件请将日志发送至 submain.com 的支持部门。
如果您包括生产版本和版本,那将非常有帮助。
我们期待与您合作解决您遇到的问题!
谢谢!