web-dev-qa-db-ja.com

XMLコードコメントのジェネリック型への参照

私が知っているように、C＃の型/メソッドのXMLコメントでは、次のようにタグでジェネリック型を参照できます。

///<see cref="name.space.typename&lt;T&rt;(paramtype)">

しかし、私は、より扱いにくい別の構文があったと思いますか？何か、それらのhtmlエンティティ '<'を取り除くために？今は見つかりません。誰か助けてもらえますか？

c#xmldocumentationreferencegenerics
55
user492238

ドキュメントに関する良い記事を以下に示します： C＃XMLドキュメントコメントFAQ

コンパイラチームは、代替構文がドキュメントコメントのジェネリック型とメソッドを参照できるようにすることで、これを改善することを決定しました。具体的には、開始と終了の山括弧を使用する代わりに、開始と終了の中括弧を使用することが合法です。上記の例は次のようになります。

class Program
{
    /// <summary>
    /// DoSomething takes a <see cref="List{T}"/>
    /// </summary>
    void DoSomething(List<int> al) { }
}

したがって、あなたの場合：

///<see cref="name.space.typename{T}( paramtype )" />

編集：上記のリンクは壊れています。未加工のhtmlを表示します。今のところリンクを残しています。 Microsoftからのいくつかの新しい参照を次に示します。

67
Metro Smurf

中かっこを使用します。

///<see cref="name.space.typename{T}(paramtype)">
8
John Saunders