Como fazer comentários XML no VS 2008 funcionam com o IntelliSense para enumerações?

Question

Parece que nem todo o XML-Commenting aparece no IntelliSense, mas talvez eu não esteja fazendo isso corretamente? De qualquer forma, estou tentando fazê -lo para que os membros de enumeração individual em uma lista de enumeração apareçam no IntelliSense com texto descritivo. Por exemplo, no método String.split, a terceira sobrecarga leva a enumeração de StringsPlitoptions como um parâmetro, como mostrado aqui:

TEXTO DE ALT HTTP://www.freeimagehosting.net/uploads/a138d36615.jpg

Entre as outras coisas que tentei:

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
...

O exemplo acima funciona, mas apenas para a primeira enumeração, não por outros.

O que estou fazendo errado?

Answer 1

Você tem a ideia certa, mas seu posicionamento de vírgula está estragando tudo. Para aparecer para as enumes individuais, coloque -as depois das vírgulas, não antes. Você pode querer colocar suas vírgulas no final de cada linha, em vez do começo nesses casos.

por exemplo

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 
...