Comentarios en C#

¿Te has preguntado cuántos tipos de comentarios existen en C#? Aquí te enumero todos los tipos de comentarios que puedes utilizar en tus aplicaciones.

Conviértete en un Máster de C# y .NET

Antes de continuar, te invito a que te suscribas a mi academia de entrenamiento para desarrolladores .NET, en la que vas a aprender sobre C#, Blazor, Xamarin, .NET MAUI, ASP.NET, entre muchos otros temas por un mínimo precio.

Ver más información

¿Para qué sirve un comentario?

Un comentario nos sirve cuando deseamos escribir texto de referencia en nuestro código fuente, ya sea para acordarnos qué hace cierta funcionalidad, o bien, para documentar ciertas partes del código.

También es común utilizarlo cuando deseamos “ocultar” piezas de código del compilador, de tal forma que no tengamos que eliminar esa pieza, ya sea porque aún no está terminada, porque tiene errores y no deja compilar la aplicación, o simplemente porque hemos reescrito la funcionalidad.

Tipos de comentarios simples en C#

El primer tipo de comentario que discutiremos, son los comentarios sencillos. Estos están representados por un par de diagonales (//), seguidos por texto. Este tipo de comentarios sirven únicamente para una sola línea. Por ejemplo, las siguientes líneas son una representación de ello.

        private void Print()
        {
            //Imprimimos un hola mundo
            Console.WriteLine("Hola Mundo");
        }

Como puedes observar, podemos escribir cualquier texto que queramos para documentar o hacer algún tipo de referencia.

Tipo de comentarios multi línea

Este tipo de comentario, al igual que los anteriores, nos servirá para ocultar al compilar algún texto. La diferencia radica en que este tipo de comentarios puede abarcar múltiples líneas, con lo que tendremos mayor margen de texto. Este comentario se representa al inicio con los caracteres (/*), lo que indica que inicia un comentario multi línea. Finalmente, tendremos que cerrar el comentario con los caracteres (*/), con lo que lograremos que el texto que se encuentre dentro de esta sección, sea ignorada. Por ejemplo:

        private void Print()
        {
            //Imprimimos un hola mundo
            //pasando una cadena estática
            //la cual podemos reemplazar con una variable
            Console.WriteLine("Hola Mundo");
        }

Es importante recalcar, que no existe límite en el número de comentarios de un progama, y es recomendable utilizar tantos como sea necesario, tanto para tí, como para compañeros que puedan llegar a leer tu código fuente.

Shortcuts (Atajos) de teclado para poner comentarios en Visual Studio ó cómo comentar varias líneas en Visual Studio y Visual Studio Code

Si quieres optimizar tus tiempos al escribir código, puedes hacer a través del los atajos del teclado. Ello se logra de la siguiente forma:

Para Comentar: Debes seleccionar una ó varias líneas que quieras comentar, y a continuación, presionar las teclas:

Ctrl + K + C – manteniendo la tecla Ctrl presionada todo el tiempo.

Para descomentar: Debes seleccionar una o varias líneas que quieras descomentar, y a continuación, presionar las teclas:

Ctrl + K + U – manteniendo la tecla Ctrl presionada todo el tiempo.