Гость
Войти | Профиль | Очистить
Действия ...
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / XML comments - IntelliSense не показывает правильно форматирование / 4 сообщений из 4, страница 1 из 1
11.01.2016, 11:32
    #39144376
Abobo
Abobo
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
XML comments - IntelliSense не показывает правильно форматирование
Есть метод в двух перегрузках - отличаются они только наличием в первой перегрузке параметра

Код: c#
1.
List<int> sourceIndices



Код: c#
1.
2.
3.
4.
5.
6.
7.
public static void Approximate<T>(List<T> sourceValues, List<int> sourceIndices, int rangeSize, out List<T> resultValues, out List<int> resultIndices)

/// <summary>
/// If you need a custom source index sequence use the overloaded version of this method - 
/// <see cref="M:Approximate{T}(List{T}, List{T}, int, out List{T}, out List{int})"/>.
/// </summary>
public static void Approximate<T>(List<T> sourceValues, int rangeSize, out List<T> resultValues, out List<int> resultIndices)



В комментарии ко второму методу хочу сослаться на первый. Чтобы это было в виде ссылки, применил такое форматирование, как выше в примере кода. Если убрать "М:" перед название метода, то пишет, что не может распознать такой XML-комментарий.

Во всплывающем окне IntelliSense комментарий выглядит как на рисунке ниже.

В самом XML данные сигнатуры методов выглядят так (убрал полные пути перед названиями методов для краткости)

Код: xml
1.
M:Approximate``1(System.Collections.Generic.List{``0},System.Collections.Generic.List{System.Int32},System.Int32,System.Collections.Generic.List{``0}@,System.Collections.Generic.List{System.Int32}@)



Код: xml
1.
M:Approximate``1(System.Collections.Generic.List{``0},System.Int32,System.Collections.Generic.List{``0}@,System.Collections.Generic.List{System.Int32}@)
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
11.01.2016, 11:36
    #39144385
Abobo
Abobo
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
XML comments - IntelliSense не показывает правильно форматирование
Т. е. на рисунке явно не то - во-первых, так должна быть гиперссылка на метод. А её нет - это просто текст. Во-вторых, не должно быть служебного форматирования {T} - это параметр типа должен быть в виде <T>.

При этом в проекте, где я скомпилировал этот XML-комментарий, никаких ошибок и предупреждений нет - т. е. вроде как всё нормально распозналось.
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
11.01.2016, 14:52
    #39144615
Abobo
Abobo
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
XML comments - IntelliSense не показывает правильно форматирование
Никто не заморачивается со сложным форматированием в ХМЛ-комментах? )
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
11.01.2016, 14:56
    #39144621
Abobo
Abobo
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
XML comments - IntelliSense не показывает правильно форматирование
Ладно, поправил ошибку у себя - второй параметр в комментарии не List{T}, а List{int}. Но всё равно ничего не изменилось - просто будет как на картинке, но показывать будет List{int}. Всё равно не форматируется в подсказке так, как надо.
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
Форумы / WinForms, .Net Framework [игнор отключен] [закрыт для гостей] / XML comments - IntelliSense не показывает правильно форматирование / 4 сообщений из 4, страница 1 из 1
Целевая тема:
Создать новую тему:
Автор:
Найденые пользователи ...
Разблокировать пользователей ...
Читали тему (0):
Читали форум (0):
Пользователи онлайн (0):
Польз. соглашение
созд. / загр.: 393ms
Закрыть
start [/forum/topic.php?fid=20&mobile=1&tid=1400904]:
 0ms
get settings:
 9ms
get forum list:
 12ms
check forum access:
 3ms
check topic access:
 3ms
track hit:
 27ms
get topic data:
 11ms
get forum data:
 2ms
get page messages:
 41ms
get tp. blocked users:
 2ms
others: 283ms
total:  393ms
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]