Comment référencer des classes génériques et méthodes dans la documentation xml

Question

Lors de la rédaction de la documentation xml, vous pouvez utiliser <see cref="something">something</see>, ce qui fonctionne bien. Mais comment faites-vous référence à une classe ou une méthode avec les types génériques?

public class FancyClass<T>
{
  public string FancyMethod<K>(T value) { return "something fancy"; }
}

Si j'allais écrire de la documentation xml quelque part, comment aurais-je de référence de la fantaisie de la classe? comment puis-je faire référence à un FancyClass<string>? Que penser de la méthode?

Par exemple, dans une classe différente, je voulais laisser l'utilisateur de savoir que je vais retourner une instance de FancyClass<int>. Comment pourrais-je faire un see cref chose pour qui?

Answer 1

Pour faire référence à la méthode :

Answer 2

<pre><code></code><p><a href="http://msdn.microsoft.com/en-us/library/acd0tfbe(VS.80).aspx">.Net framework 2.0</a> <a href="http://msdn.microsoft.com/en-us/library/acd0tfbe(VS.85).aspx">3.0</a> <a href="http://msdn.microsoft.com/en-us/library/acd0tfbe.aspx">version 3.5</a></p></pre>

Answer 3

Outre des réponses par Lasse et T.B.C :

fournira également des info-bulles correctement, alors que leur version rend les accolades.

Answer 4

/// <see cref="FancyClass&lt;T>.FancyMethod&lt;K>(T)"/> for more information.