代码检查:在根级别使用 <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日