【Visual Studio】特定メンバーのXMLコメントを使う

やりたいこと

例えば、下のようなクラスがあったとき、HogeClass は Hoge プロパティ専用のクラスなので、Hoge プロパティの XML コメントを、HogeClass のと同じに（共通化）したいと思った。

class TestClass
{
	// このsummaryを、HogeClassと共通化したい
	/// <summary>
	/// 説明文
	/// </summary>
	public HogeClass Hoge { get; }

	/// <summary>
	/// 説明文
	/// </summary>
	public class HogeClass { }
}

解決策

summary タグの代わりに、 inheritdoc タグを使い、cref="" に XML コメントを同じにしたいメンバーの名前を入れる。

class TestClass
{
	/// <inheritdoc cref="HogeClass"/>
	public HogeClass Hoge { get; }

	/// <summary>
	/// 説明文
	/// </summary>
	public class HogeClass { }
}

参考

• クラスとそのメンバー用として推奨される XML ドキュメント タグ | Microsoft Docs