2012-03-02 15 views
0

コメント:実装方法については フィルターの内容は、私がこのようにコメントしてい

/// <summary>some summary</summary> 
/// <param name="a"> 
///  <para id="0">Comment 0</para> 
///  <para id="1">Comment 1</para> 
///  <para id="2">Comment 2</para> 
/// </param> 
/// <param name="b"> 
///  <para id="1">Comment 3</para> 
///  <para id="0">Comment 4</para> 
/// </param> 
void InterfaceMethod(int a, int b); 

を、私は、同じドキュメントを持ちたいが、これらの段落はinheritdocを使用して、id="0"を有しないと思います。 inheritdoc要素を作成するにはどうすればよいですか?

この文脈では、id属性を珍しく使用すると、ドキュメンテーションに表示されているように段落の順序に束縛されない柔軟性が追加されます。

答えて

0

解決策が見つかりましたが、扱いにくいようです。

/// <summary><inheritdoc/></summary> 
/// <param name="a"><inheritdoc select="node()[parent::node()[@name='a'] and @id&gt;0]"/></param> 
/// <param name="b"><inheritdoc select="node()[parent::node()[@name='b'] and @id&gt;0]"/></param> 
public void InterfaceMethod(int a, int b) { } 

it is not possible to use XPath expressions as a filterとして、param要素が繰り返されなければなりません。 式@id>0>をエスケープする必要があります)では、目的の段落のみが選択されるようになりました。

他のマークアップについてはどうですか? ネストしたinheritdoc要素は、すべてparamというノードの内容を選択するので、親のname属性に条件を追加する必要があります。

最後に、summaryタグ内のinheritdocタグが要約をコピーします。ルートレベルにinheritdocを配置すると、hereのようにparamが再び選択されます。

関連する問題