Как иметь комментарии в IntelliSense для функции в Visual Studio?

Грозный не работает с облачными функциями , по той же причине, по которой не работает. Вместо этого пользуйтесь автобусом. Как выполнить загрузку файла HTTP с помощью Express on Cloud Functions для Firebase (multer, busboy) Так что этот вопрос так или иначе связан с вышеуказанными проблемами в ссылках, если кто-то не возражает, как сейчас ...

132
задан Glorfindel 28 February 2019 в 20:03
поделиться

7 ответов

Для генерации области, где можно определить описание для функции и каждый параметр для функции введите следование строки перед функцией и совершите нападки Входят :

  • C#: ///

  • VB: '''

Видят Рекомендуемые Теги для Комментариев для документации (Руководство по программированию C#) для большего количества информации о структурированном содержании, которое можно включать в эти комментарии.

206
ответ дан 24 November 2019 в 00:08
поделиться

Также дополнительный фантомный документ Visual Studio попытается создать и временная замена комментарии заголовка с Вашего имени функции.

1
ответ дан 24 November 2019 в 00:08
поделиться

Сделайте комментарий XML, как это

/// <summary>
/// This does something that is awesome
/// </summary>
public void doesSomethingAwesome() {}
11
ответ дан 24 November 2019 в 00:08
поделиться

используйте///для начала, каждая строка комментария и иметь комментарий содержат соответствующий xml для читателя метаданных.

///<summary>
/// this method says hello
///</summary>
public void SayHello();

, Хотя лично, я полагаю, что эти комментарии обычно дезинформируются, если Вы не разрабатываете классы, где код не может быть прочитан его потребителями.

10
ответ дан 24 November 2019 в 00:08
поделиться

Solmead имеет корректный ответ. Для большего количества информации можно посмотреть XML-комментарии .

0
ответ дан 24 November 2019 в 00:08
поделиться

Их называют XML-комментарии . Они были частью Visual Studio с тех пор навсегда.

можно сделать процесс документации легче при помощи GhostDoc, свободное дополнение для Visual Studio, которая генерирует комментарии XML-документа для Вас. Просто поместите свое каре в метод/свойство, Вы хотите зарегистрировать, и нажать Ctrl-Shift-D.

Вот пример от одно из моих сообщений .

Hope, которая помогает:)

9
ответ дан 24 November 2019 в 00:08
поделиться

То, в чем Вы нуждаетесь, комментарии xml - в основном, они следуют за этим синтаксисом (как неопределенно описано Solmead):

C#

///<summary>
///This is a description of my function.
///</summary>
string myFunction() {
     return "blah";
}

VB

'''<summary>
'''This is a description of my function.
'''</summary>
Function myFunction() As String
    Return "blah"
End Function
66
ответ дан 24 November 2019 в 00:08
поделиться
Другие вопросы по тегам:

Похожие вопросы: