<exclude>【出力除外】
<inheritdoc>【ドキュメント継承】
<preliminary>【暫定】
メモ
<exclude>【出力除外】
- 出力から除外
<inheritdoc>【ドキュメント継承】
- ドキュメントを継承して出力
- 型・インタフェース・仮想メンバ・インタフェースメンバ実装・コンストラクタで指定する場合、cref属性は省略可 (基本クラスから継承)
- cref属性指定:未継承のコメント挿入可
- select属性指定:部分的なコメント挿入可
<preliminary>【暫定】
- 暫定的で変更の可能性あり
- クラス等に指定すると、メンバ全てが対象
構文
<exclude />
<inheritdoc />
<inheritdoc [cref="メンバ名"] [select="XPath"] />
XPathの例:
"param":パラメータのみ継承
"summary|remarks":概要と備考を継承
<preliminary />
<preliminary>暫定の説明</preliminary>
外部リンク
- Sandcastle Help File Builder (英語)
例
/// <summary>クラスの概要 (ClassBase)</summary>
/// <remarks>クラスの備考 (ClassBase)</remarks>
public class ClassBase
{
/// <summary>コンストラクタの概要 (ClassBase)</summary>
/// <remarks>コンストラクタの備考 (ClassBase)</remarks>
public ClassBase() { }
}
/// <inheritdoc/>
public class ClassInherit : ClassBase
{
/// <inheritdoc/>
public ClassInherit() : base() { }
/// <summary>メソッドAの概要</summary>
/// <remarks>メソッドAの備考</remarks>
/// <param name="p1">パラメータ1の説明</param>
/// <seealso cref="ClassBase"/>
public void MethodA(int p1) { }
/// <summary>メソッドBの概要</summary>
/// <inheritdoc cref="MethodA" select="remarks|param"/>
/// <param name="p2">パラメータ2の説明</param>
public void MethodB(int p1, int p2) { }
/// <exclude/>
public void MethodExclude() { }
/// <summary>暫定メソッド</summary>
/// <preliminary/>
public void MethodTemp() { }
}