Теория: Комментарии

Практически все языки программирования позволяют оставлять в коде комментарии. Они никак не используются кодом и нужны исключительно для людей: чтобы программист оставлял пометки для себя и для других программистов. Комментарии в C# бывают трёх видов:

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

Комментарий может занимать всю строчку:

// For Winterfell!

или может находиться на строчке после какого-нибудь кода:

Console.WriteLine("I am the King"); // => For Lannisters!

Многострочные комментарии начинаются с /* и заканчиваются на */. Принято каждую строчку начинать с символа *, хотя технически это и не обязательно.

/*
* The night is dark and
* full of terrors.
*/
Console.WriteLine("I am the King"); // => I am the King

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

Документирующие комментарии, являясь, по сути, подвидом однострочных, несут дополнительную функцию – добавляют подсказки к коду для внешних пользователей нашего кода. Мы поговорим о них позже – когда разберём классы и методы.