Генератор комментариев для документации

@dailydose · Регистрация: 21.07.2016

Студворк — интернет-сервис помощи студентам

Есть какие-либо плагины для MSVS2015 для создания подобных комментариев?

C#
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        /// <summary>
        /// Divides the two numbers specified and returns the result.
        /// </summary>
        /// <param name="number1">
        /// A <see cref="System.Int32"/>
        /// </param>
        /// <param name="number2">
        /// A <see cref="System.Int32"/>
        /// </param>
        /// <throws>
        /// A <see cref="DivideByZeroException"/>
        /// </throws>
        /// <returns>
        /// A <see cref="System.Int32"/>
        /// </returns>
        public int Divide(int number1, int number2)
        {
            return result = number1 / number2;
        }

Например в том же PhpStorm есть PhpDoc который сам генерирует подобные комментарии после написания /** и нажатия ENTER

@Usaga · 05.12.2017, 10:26

dailydose, просто трижды нажмите "/" перед именем метода.

@dailydose · 05.12.2017, 10:55 **[ТС]**

Сообщение от Usaga

просто трижды нажмите "/" перед именем метода.

подставляется пустой комментарий

/// <summary>
///
/// </summary>

т.е. автоматически не анализируются ни параметры, ни возвращаемое значение и прр

@Usaga · 05.12.2017, 11:00

dailydose, у меня работает корректно...

@Почтальон · 05.12.2017, 13:16

dailydose, тоже сейчас проверил - работает корректно, если имеются параметры

@dailydose · 05.12.2017, 15:22 **[ТС]**

ну собственно есть такой код

C#
1
2
3
4
5
6
7
8
9
        private Type FindProgram(string programName)
        {
            var targetName = ParseProgramName(programName);
            if (targetName == null)
                return null;
 
            var programType = Type.GetType(GetType().Namespace + "." + targetName + "." + EntryPointClassname);
            return programType;
        }

и вот такой комментарий получаю на выходе

/// <summary>
///
/// </summary>
/// <param name="programName"></param>
/// <returns></returns>

@Usaga · 05.12.2017, 16:46

dailydose, ну, всё корректно.

Новые блоги и статьи Все статьи Все блоги /
Оттенки серого Argus19 18.03.2026 Оттенки серого Нашёл в интернете 3 прекрасных модуля: Модуль класса открытия диалога открытия/ сохранения файла на Win32 API; Модуль класса быстрого перекодирования цветного изображения в оттенки. . .	SDL3 для Desktop (MinGW): Рисуем цветные прямоугольники с помощью рисовальщика SDL3 на Си и C++ 8Observer8 17.03.2026 Содержание блога Финальные проекты на Си и на C++: finish-rectangles-sdl3-c. zip finish-rectangles-sdl3-cpp. zip	Символические и жёсткие ссылки в Linux. algri14 15.03.2026 Существует два типа ссылок — символические и жёсткие. Ссылка в Linux — это запись в каталоге, которая может указывать либо на inode «файла-ИСТОЧНИКА», тогда это будет «жёсткая ссылка» (hard link),. . .	[Owen Logic] Поддержание уровня воды в резервуаре количеством включённых насосов: моделирование и выбор регулятора ФедосеевПавел 14.03.2026 Поддержание уровня воды в резервуаре количеством включённых насосов: моделирование и выбор регулятора ВВЕДЕНИЕ Выполняя задание на управление насосной группой заполнения резервуара,. . .
делаю науч статью по влиянию грибов на сукцессию anaschu 13.03.2026 прикрепляю статью	SDL3 для Desktop (MinGW): Создаём пустое окно с нуля для 2D-графики на SDL3, Си и C++ 8Observer8 10.03.2026 Содержание блога Финальные проекты на Си и на C++: hello-sdl3-c. zip hello-sdl3-cpp. zip Результат:	Установка CMake и MinGW 13.1 для сборки С и C++ приложений из консоли и из Qt Creator в EXE 8Observer8 10.03.2026 Содержание блога MinGW - это коллекция инструментов для сборки приложений в EXE. CMake - это система сборки приложений. Здесь описаны базовые шаги для старта программирования с помощью CMake и. . .	Как дизайн сайта влияет на конверсию: 7 решений, которые реально повышают заявки Neotwalker 08.03.2026 Многие до сих пор воспринимают дизайн сайта как “красивую оболочку”. На практике всё иначе: дизайн напрямую влияет на то, оставит человек заявку или уйдёт через несколько секунд. Даже если у вас. . .

@Usaga 14307 / 9388 / 1355 Регистрация: 21.01.2016 Сообщений: 35,405
	05.12.2017, 10:26
	dailydose, просто трижды нажмите "/" перед именем метода. 1

@Usaga 14307 / 9388 / 1355 Регистрация: 21.01.2016 Сообщений: 35,405
	05.12.2017, 11:00
	dailydose, у меня работает корректно... 0

@Почтальон управление сложностью 1693 / 1306 / 259 Регистрация: 22.03.2015 Сообщений: 7,545 Записей в блоге: 5
	05.12.2017, 13:16
	dailydose, тоже сейчас проверил - работает корректно, если имеются параметры 0

@Usaga 14307 / 9388 / 1355 Регистрация: 21.01.2016 Сообщений: 35,405
	05.12.2017, 16:46
	dailydose, ну, всё корректно. 1