Как заставить комментарии Xml в VS 2008 работать с Intellisense для перечислений? - PullRequest
3 голосов
/ 12 февраля 2010

Похоже, что не все 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
...

Приведенный выше пример работает, но только для первого перечисления, а не для любых других.

Что я делаю не так?

1 Ответ

3 голосов
/ 12 февраля 2010

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

, например

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