odniesienie do typu generic w kodzie XML komentarz [duplikat]

To pytanie ma już odpowiedź tutaj:

Jak wiem, w komentarzu XML dla typu / metody C# można odwołać się do typu generycznego w tagu takim jak:

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

Ale myślę, że była inna składnia, która jest mniej niezdarna? Coś, żeby się pozbyć te encje html'

Author: user492238, 2011-02-17

2 answers

Oto dobry artykuł na temat dokumentacji: C# XML documentation comments FAQ

Zespół kompilatorów postanowił poprawić to poprzez umożliwienie alternatywnej składni odnosić się do typów i metod generycznych w komentarzach do doc. W szczególności, zamiast używać open and close wsporniki kątowe legalne jest używanie Otwórz i zamknij kręcone szelki. Na przykład powyżej będzie wtedy:

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

Więc w Twoim przypadku:

///<see cref="name.space.typename{T}( paramtype )" />
 61
Author: Metro Smurf,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/doraprojects.net/template/agent.layouts/content.php on line 54
2011-02-17 14:44:20

Użyj nawiasów klamrowych:

///<see cref="name.space.typename{T}(paramtype)">
 7
Author: John Saunders,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/doraprojects.net/template/agent.layouts/content.php on line 54
2011-02-17 14:40:33