Как ссылаться на конкретные реализации универсальных интерфейсов в комментариях XML? - PullRequest
0 голосов
/ 15 июня 2009

Рассмотрим этот сценарий, 2 интерфейса, 1 универсальный:

public IGenericAdder<T>
{
   T Add(T, T);
}

public IIntAdder : IGenericAdder<Int32>
{
}

Есть ли какой-нибудь способ, которым я могу сделать XML-комментарии к универсальному методу добавления, так что intellisense покажет «Добавляет Int32», если я сделаю:

IIntAdder foo;
foo.Add(  //Show intellisense here

Ответы [ 2 ]

1 голос
/ 15 июня 2009

Я не думаю, что есть способ. Вы могли бы:

  • Сделайте комментарий достаточно универсальным для работы (т. Е. «Добавляет два элемента вместе») и позвольте пользователю определить тип из сгенерированной Visual Studio документации / всплывающей подсказки.
  • Скройте T Add(T, T) метод IGenericAdder с new int Add(int, int) в IIntAdder и поместите в него конкретные документы XML, которые ссылаются на правильные типы (т. Е. «Складывает два целых»).
  • Используйте в документах XML, но Visual Studio просто ссылается на него как T.

Однако ни один из них не делает то, что вы изначально просили.

0 голосов
/ 15 июня 2009

Вам не нужен комментарий к документу - Visual Studio автоматически заполняет аргумент универсального типа во всплывающей подсказке.

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