文档规则
文档规则支持通过正确为外部可见的 API 使用 XML 文档注释来编写记录详尽的库。
本节内容
规则 | 描述 |
---|---|
CA1200:不要使用带前缀的 cref 标记 | XML 文档标记中的 cref 属性表示“代码引用”。 它指定标记的内部文本是代码元素,如类型、方法或属性。 避免将 cref 标记与前缀一起使用,因为它会阻止编译器验证引用。 它还可防止 Visual Studio 集成开发环境(IDE)在重构期间查找和更新这些符号引用。 |
文档规则支持通过正确为外部可见的 API 使用 XML 文档注释来编写记录详尽的库。
规则 | 描述 |
---|---|
CA1200:不要使用带前缀的 cref 标记 | XML 文档标记中的 cref 属性表示“代码引用”。 它指定标记的内部文本是代码元素,如类型、方法或属性。 避免将 cref 标记与前缀一起使用,因为它会阻止编译器验证引用。 它还可防止 Visual Studio 集成开发环境(IDE)在重构期间查找和更新这些符号引用。 |