Comments in C#

Comments allow us to include notes and explanations within the code. These notes help make the code easier to understand for both other programmers and ourselves when reviewing the project in the future.

Additionally, comments allow temporarily disabling code snippets without deleting them, which is useful for testing and debugging (but only for testing, leaving it there is a mess 😊).

In C#, there are several types of comments that allow annotating the code in different ways:

Single-line comments

Single-line comments in C# begin with two forward slashes (//). Any text that follows // on the same line is considered a comment and is ignored by the compiler.

These comments are appropriate for brief annotations or for temporarily disabling a line of code:

// This is a single-line comment
int result = 5 + 3; // Sum of two numbers

Multi-line comments

When more extensive comments are needed, multi-line comments are a suitable option. These comments start with /* and end with */.

Everything between these two symbols will be treated as a comment and will not be executed.

/* This is a multi-line comment.
   It can span multiple lines and is useful
   when you need to explain the purpose of
   a block of code or include a detailed description. */
int result = 5 * 10;

XML comments

C# also allows creating XML comments, which are especially useful for documenting methods, classes, and properties.

XML comments begin with three forward slashes (///) and can contain tags like <summary>, <param>, and <returns>. Here’s an example:

/// <summary>
/// Calculates the sum of two integers.
/// </summary>
/// <param name="a">The first number to add.</param>
/// <param name="b">The second number to add.</param>
/// <returns>The result of adding both numbers.</returns>
public int Add(int a, int b)
{
    return a + b;
}

In this example: