#c# #.net #comments #word-wrap #xml-comments
#c# #.net #Комментарии #перенос слов #xml-комментарии
Вопрос:
Я хотел бы иметь одну команду для автоматической обтекания комментариев в стиле XML в .NET.
Пример:
/// <summary>
/// This comment line should be
/// on one line, and other lines in this <summary> block should be wordwrapped.
/// </summary>
Я бы не прочь купить некоторые коммерческие плагины Visual Studio, если они способны это делать.
Комментарии:
1. когда вы нажимаете три раза на символ ‘/’, vs создает сводку (это функция resharper?)
2. Нажатие «/» 3 раза создает сводный блок по умолчанию в Visual Studio; это не часть Resharper; хотя вы можете получить плагины, которые разумно заполняют сводку вместо этого.
3. Какие плагины разумно заполняют сводку?
Ответ №1:
Попробуйте пробную версию ReSharper, в ней указано, что она форматирует комментарии XML Doc (перейдите сюда и найдите комментарии XML doc для получения дополнительной информации) и, как правило, очень настраиваема.
Если это не сработает, ближайшая вещь, которую я смог найти, была в CodeProject , она предназначена для Visual Studio 2003; однако она с открытым исходным кодом, поэтому вы можете заставить ее работать без дорогостоящего стороннего плагина.
Ответ №2:
Я написал дополнение для документации Visual Studio, AtomineerUtils Pro, которое будет обновлять и переносить в текст как обычные комментарии, так и комментарии к документации (в форматах XML, Doxygen, Qt и JavaDoc). (Это не бесплатно, но очень недорого, и есть 30-дневная бесплатная пробная версия)
Он пытается разумно сохранить важные символы новой строки — текст, такой как отступ, маркированные списки, пустые строки или двойной пробел в конце строки (среди прочего), будут использоваться в качестве подсказок для механизма переноса, чтобы гарантировать, что ваше форматирование не будет потеряно.
Ответ №3:
Добавьте <para /> в свои комментарии