代码检查:在根级别使用 <inheritdoc /> 以继承基础候选的文档
当成员重写或实现已记录的基成员但没有继承文档而重复其自己的 XML 文档块时,此检查建议使用根级别的 <inheritdoc /> 标记。 使用 <inheritdoc /> 可以让意图更加清晰,并有助于避免文档重复或偏离。
示例
public interface IC
{
/// <summary>Base summary</summary>
void Foo();
}
public class C : IC
{
/// <summary>New summary</summary>
public void Foo()
{
}
}
public interface IC
{
/// <summary>Base summary</summary>
void Foo();
}
public class C : IC
{
/// <inheritdoc />
/// <summary>New summary</summary>
public void Foo()
{
}
}
快速修复
将 <inheritdoc /> 标记添加到 XML 文档块。
2026年 5月 8日