Comment faire des commentaires Xml dans le travail VS 2008 avec IntelliSense pour énumérations?

Question

Il semble que tous les spectacles Xml-Commentant haut dans IntelliSense, mais peut-être que je ne le fais pas correctement? Quoi qu'il en soit, je suis en train de faire en sorte que les membres d'énumération individuels dans une liste d'énumération apparaissent dans IntelliSense avec un texte descriptif. Par exemple, dans la méthode String.Split, la troisième surcharge prend l'énumération StringSplitOptions comme paramètre, comme indiqué ici:

texte alt http://www.freeimagehosting.net/uploads/a138d36615.jpg

Parmi les autres choses que j'ai essayé:

public enum ErrorTypeEnum
{
   /// <summary>The process could not identify an agency </summary>
   BatchAgencyIdentification       // Couldn't identify agency
   /// <summary>The batch document category was invalid.</summary>
   , BatchInvalidBatDocCatCode     // Anything other than "C"
   /// <summary>The batch has no documents.</summary>
   , BatchHasNoDocuments           // No document nodes
...

L'exemple ci-dessus le travail, mais seulement pour la première énumération, pas d'autres.

Qu'est-ce que je fais mal?

Answer 1

Vous avez la bonne idée, mais votre placement virgule est le vissant vers le haut. Pour obtenir apparaître les énumérations individuels, placez-les AFTER les virgules, pas avant. Vous pouvez mettre vos virgules à la fin de chaque ligne au lieu du début dans ces cas.

par exemple.

public enum ErrorTypeEnum 
{ 
   /// <summary>The process could not identify an agency </summary> 
   BatchAgencyIdentification,       // Couldn't identify agency 
   /// <summary>The batch document category was invalid.</summary> 
   BatchInvalidBatDocCatCode,     // Anything other than "C" 
   /// <summary>The batch has no documents.</summary> 
   BatchHasNoDocuments           // No document nodes 
...