Как вы предоставляете XML-комментарии / документацию для параметров делегата? - PullRequest
8 голосов
/ 13 февраля 2010

для данного делегата, как

Func<string,string,string> MyFunc = (firstName,lastName) => string.Format("Given Name:{0} Surname:{1}",
                                                                            firstName,
                                                                            lastName);

Как бы вы могли документировать параметры firstName и lastName, чтобы они отображались в intellisense (как это делают описания методов и параметры)?
Пример:

/// <summary>
/// My Method
/// </summary>
/// <param name="firstName">The first name.</param>
/// <param name="lastName">The last name.</param>
/// <returns></returns> 
public string MyMethod(string firstName, string lastName)
{ 
  return string.Format("Given Name:{0} Surname:{1}",firstName,lastName);
}

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

1 Ответ

10 голосов
/ 13 февраля 2010

Поле типа делегата по-прежнему является полем, а не методом & mdash; оно не принимает параметры само по себе. Параметры принадлежат делегату тип , а не делегату поле . Вы можете написать комментарии к параметрам при делегировании типов, если хотите.

/// <summary>
/// Tests something.
/// </summary>
/// <param name="test">Something that's going to be tested.</param>
delegate void Test(int test);

Func<string,string,string> - общий делегат для функций с тремя параметрами. В определенных целях вы всегда можете объявить свой собственный тип делегата, который более конкретно представляет абстрактный метод, и добавить комментарии к его параметрам.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...