XML commentaire sur plusieurs lignes en C# - ce que je fais mal?

Selon cet article, il est possible d'obtenir des commentaires XML multilignes -- au lieu d'utiliser ///, utilisez /** */. Voici mon interprétation de ce que sont les commentaires multilignes, et de ce que je veux qu'il arrive:

/**
 * <summary>
 * this comment is on line 1 in the tooltip
 * this comment is on line 2 in the tooltip
 * </summary>
 */

cependant, lorsque j'utilise ce formulaire, l'infobulle qui apparaît lorsque je survole mon nom de classe dans mon code est une ligne simple, c'est-à-dire qu'il semble exactement comme si j'avais écrit mon commentaire comme ceci:

/// <summary>
/// this comment is on line 1 in the tooltip
/// this comment is on line 2 in the tooltip
/// </summary>

ce comportement est-il réellement encore possible en VS2008?

EDIT

gabe fait remarquer que j'ai mal compris ce que" multiligne " signifie, Et je dois en fait utiliser <para> ou <br> pour obtenir mon effet escompté. Je suis allé de l'avant et utilisé <br> parce que je veux contrôler où les sauts de ligne se produisent, i.e.

/// <summary>
/// this comment is on line 1 in the tooltip<br/>
/// this comment is on line 2 in the tooltip<br/>
/// </summary>

quand je regarde le tooltip de cette classe dans mon code, tout finit toujours sur une ligne... WTH? Ai-je fais quelque chose de mal ici?

UPDATE

Ok, je suis allé de l'avant et a essayé de la <para> tags sur chaque ligne, et ça marche. Je ne sais pas pourquoi <br/> doesn'T.

/// <summary>
/// <para>this comment is on line 1 in the tooltip</para>
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>
26
demandé sur Micha Wiedenmann 2010-03-30 21:43:16

3 réponses

on dirait que vous êtes confus sur ce que "multi-ligne" signifie. Un commentaire sur une seule ligne se termine à la fin de la ligne de code source, et si vous voulez continuer ce commentaire vous devez mettre un "///" sur la ligne suivante. Un commentaire de plusieurs lignes commence par un "/*" et se termine par un "*/ " de sorte qu'il peut se terminer soit sur la même ligne ou plusieurs lignes vers le bas.

être "multi-ligne" ne dit rien sur la façon dont le texte dans le commentaire est affiché. Pour mettre un saut de ligne dans un XML commentaire vous devez insérer un <br/> ("pause") ou d'enrouler la ligne <para> ("paragraphe") de la balise.

16
répondu Gabe 2010-04-01 00:39:28

Essayez ceci

/// <summary>
/// this comment is on line 1 in the tooltip
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>
13
répondu bic 2010-03-30 17:46:50

Ajouter <br/> pour les sauts de ligne ou de joindre les paragraphes <para>...</para>. C'est juste comme XML et HTML, la rupture de ligne n'est rien d'autre que des espaces.

0
répondu Lucero 2010-03-30 17:46:17