Se référant à un type générique d’un type générique dans la documentation XML C #?

Écrire une documentation XML pour une classe auxiliaire de prédicat. Mais je ne peux pas comprendre que je peux faire référence à une Expression<Func> sans obtenir d’erreur de syntaxe. Est-ce que c’est même possible? J’ai essayé ceci:

  

Mais j’ai une ligne rouge ondulée sous {T, bool}} . Cela fonctionne bien:

  

Quelqu’un a une idée?


Mettre à jour:

La réponse qui a été donnée (et j’ai accepté) a apparemment fonctionné. Mais maintenant, j’ai commencé à recevoir beaucoup d’avertissements sur des choses qui ne pouvaient pas être résolues. J’ai une classe appelée ExpressionBuilder qui fonctionne avec Expression<Func> beaucoup. Donc, bien sûr, je veux faire référence à cela dans mes commentaires XML.

J’ai essayé les deux versions que je connais:

   

Mais ni travail, (Et sur le dernier, ReSharper met une ondulation bleue sous {T,Boolean}} Je reçois deux avertissements sous compilation partout où je l’ai utilisé, ce qui indique que:

  1. Un commentaire XML sur ‘blah blah’ a l’atsortingbut cref ‘Expression>’ qui n’a pas pu être résolu
  2. La déclaration de paramètre de type doit être un identificateur et non un type. Voir aussi l’erreur CS0081.

Avoir le même problème quelque part que j’ai essayé de faire référence à la Range<Nullable> (la Range Range<Nullable> pas fonctionné non plus. Les deux avec {} et avec < > )

Ne suis-je pas censé faire référence à ces types de génériques?

Il ne semble y avoir aucun moyen de faire référence à un générique de générique dans la documentation XML, car en réalité, il est impossible de faire référence à un générique de type spécifique.

La réponse de Lasse V Karlsen l’a fait cliquer pour moi:

Si vous écrivez , le compilateur utilise simplement “Int32” comme nom de paramètre de type, pas l’argument de type. Ecrire fonctionnerait aussi bien. Cela a du sens car il n’y a pas de page spécifique dans MSDN pour “IEnumerable of int” vers laquelle votre documentation pourrait être liée.

Pour documenter correctement votre classe, je pense que vous devriez écrire quelque chose comme:

  Returns an  of  of , .  

J’espère que vous aimez le texte.

A quoi voudriez-vous qu’il soit lié?

La documentation ne contient pas une Expression> , de sorte qu’il est évident qu’un lien vers cette Expression> ne fonctionnerait pas.

Vous pouvez Expression lien vers Expression car cela existe.

En ce qui concerne ce qui fonctionne ou pas, ni l’un ni l’autre ne fonctionne dans Visual Studio 2008 / .NET 3.5 pour moi:

 /// . /// . 

Mais cela fonctionne:

 /// . 

Donc, apparemment, le paramètre de type générique n’a pas le même que celui de la déclaration.

 // Use "<" instead of "<" symbol and ">" instead of ">" symbol. // Sample:  

Je cours maintenant, car j’ai une fonction qui retourne une List> . Oui, c’est moche, mais je ne l’ai pas écrit. Désistement standard, je sais.

Quoi qu’il en soit, dans VS 2017 avec R # Ultimate 2017.1, ce document commente …

  of split frames 

… me donne une erreur de syntaxe. Cependant, cela …

List{List{byte}} of split frames

…ne fait pas. Eeeenteresting .

Encore moche? Oui.

Comme moche? Je pense que c’est moins horrible que d’utiliser < et > moi même….

N’utilisez pas d’élément see vide ( ). Au lieu de cela, mettez du texte à l’intérieur de l’élément see

 IEnumerable<$gt;