1

Жил я себе не тужил, расширял контроллеры своими методами, и писал атрибуты в стиле

    [HtpPost("А этот метод выдаёт отчет номер два!")]
    public async Task<List<string>> GetReport2(){ ... }

и очень радовался, что надпись А этот метод выдаёт отчет номер два! хорошо видна в swagger- интерфейсе.

И тут оказалось, что вообще-то это - имя темплейта, и вообще так писать нельзя.

Что же делать? Видимо, есть какой-то волшебный атрибут, чтобы написать комментарий, и его было видно в сваггере.

Пока просмотрел штук пять "руководств" - нигде про комментарии при помощи атрибутов в контроллерах ни слова.

Может, кто то знает эту магию?

Спасибо!

1
  • Swagger генерирует страницу на основе xml коментов, которые в свою очередб генерятся на основе summary коментов. Чтобы сгенерировать summary комментарий - достаточно в коде написать три слеша (VS) и сгенерится комментарий (например для функции), в котором будут отображены входящие и исходящие параметры автоматом...останется только написать что они значат. Поэтому читайте про summary и смотрите что туда можно записать...и свагер по нему сгенерит описание api 12 июл в 10:47

1 ответ 1

2

А ларчик просто открывался.

Вот так вот правильно:

    /// <summary> А этот метод выдаёт отчет номер два! <summary>
    [HtpPost("[action]")]
    public async Task<List<string>> GetReport2(){ ... }

Ваш ответ

By clicking “Отправить ответ”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.