Как заставить комментарии Xml в VS 2008 работать с Intellisense для перечислений?

Question

Похоже, что не все комментарии Xml отображаются в Intellisense, но, возможно, я делаю это неправильно?В любом случае, я пытаюсь сделать так, чтобы отдельные члены перечисления в списке перечисления отображались в intellisense с описательным текстом.Например, в методе String.Split третья перегрузка принимает перечисление StringSplitOptions в качестве параметра, как показано здесь:

альтернативный текст http://www.freeimagehosting.net/uploads/a138d36615.jpg

Среди прочего, что я пробовал:

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

Приведенный выше пример ДЕЙСТВИТЕЛЬНО работает, но только для первого перечисления, а не для других.

Что я делаю неправильно?

Answer 1

У вас правильная идея, но ваша запятая все портит.Чтобы отдельные перечисления отображались, размещайте их ПОСЛЕ запятых, а не перед ними.В таких случаях вы можете ставить запятые в конце каждой строки, а не в ее начале.

например

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