Примечания кода — // и /* - */

C# поддерживает две различные формы комментариев. Примечания в одной строке начинаются и // заканчиваются в конце этой строки кода. Многостроковые комментарии начинаются с /* и заканчиваются */.

Справочные документы на языке C#, выпущенные последней версией языка C#. Она также содержит начальную документацию по функциям в общедоступных предварительных версиях для предстоящего языкового выпуска.

Документация определяет любую функцию, впервые представленную в последних трех версиях языка или в текущих общедоступных предварительных версиях.

Подсказка

Чтобы узнать, когда функция впервые появилась в C#, ознакомьтесь со статьей по журналу версий языка C#.

В следующем коде показан пример каждой формы:

// This is a single line comment.

/* This could be a summary of all the
   code that's in this class.
   You might add multiple paragraphs, or links to pages
   like https://learn.microsoft.com/dotnet/csharp.
   
   You could even include emojis. This example is 🔥
   Then, when you're done, close with
   */

Для вставки текста в строку кода можно использовать многострочный комментарий. Так как эти примечания имеют явный символ закрытия, вы можете включить более исполняемый код после комментария:

public static int Add(int left, int right)
{
    return left /* first operand */ + right /* second operand */;
}

Однострочный комментарий может отображаться после исполняемого кода в той же строке. Комментарий заканчивается в конце текстовой строки:

return source++; // increment the source.

Некоторые комментарии начинаются с трех косой черты: /// Примечания с тройной косой чертой — это комментарии к XML-документации. Компилятор считывает эти комментарии для создания человеческой документации. Дополнительные сведения о комментариях к XML-документам см. в разделе о комментариях с тройной косой чертой.