コードインスペクション:ルートレベルで <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()
{
}
}
クイックフィックス
XML ドキュメントブロックに <inheritdoc /> タグを追加します。
2026 年 6 月 12 日