Información sobre cómo usar el editor de código con C#

Artículo
06/19/2023

En esta introducción de 10 minutos al editor de código en Visual Studio, se agrega código a un archivo para ver algunas de las formas en que Visual Studio hace que escribir y comprender el código de C# (así como desplazarse por él) sea más fácil.

Si todavía no ha instalado Visual Studio, vaya a la página de descargas de Visual Studio para instalarlo de forma gratuita.

En este artículo se da por hecho que ya está familiarizado con C#. Si no lo está, le aconsejamos que antes eche un vistazo a un tutorial del tipo Introducción a C# y ASP.NET Core en Visual Studio.

Sugerencia

Para realizar los procedimientos de este artículo, asegúrese de que tiene la configuración de C# seleccionada en Visual Studio. Para más información sobre cómo seleccionar configuraciones del entorno de desarrollo integrado (IDE), vea Select environment settings (Seleccionar la configuración del entorno).

Crear un archivo de código

Empezaremos creando un archivo y agregándole código.

Abra Visual Studio. Presione Esc o haga clic en Continuar sin código en la ventana de inicio para abrir el entorno de desarrollo.
En el menú Archivo de la barra de menús, elija Nuevo>Archivo o presione Ctrl+N.
En el cuadro de diálogo Nuevo archivo, en la categoría General, elija Clase de Visual C# y, después, elija Abrir.

Se abre un archivo nuevo en el editor con el esqueleto de una clase de C#. (Observe que no es necesario crear un proyecto de Visual Studio completo para aprovechar algunas de las ventajas que ofrece el editor de código; lo único que se necesita es un archivo de código).

Abra Visual Studio. Presione Esc o elija Continuar sin código en la ventana de inicio para abrir el entorno de desarrollo.
En el menú Archivo de la barra de menús, elija Nuevo>Archivo o presione Ctrl+N.
En el cuadro de diálogo Nuevo archivo, en la categoría General, elija Clase de Visual C# y, después, elija Abrir.

Se abre un archivo nuevo en el editor con el esqueleto de una clase de C#. No es necesario crear un proyecto de Visual Studio completo para aprovechar algunas de las ventajas que ofrece el editor de código; lo único que se necesita es un archivo de código.

Uso de fragmentos de código

Visual Studio proporciona fragmentos de código muy prácticos que pueden servir para generar bloques de código de uso común de forma rápida y sencilla. Existen fragmentos de código disponibles para diferentes lenguajes de programación, como C#, Visual Basic y C++.

Vamos a agregar el fragmento de código de C# void Main a nuestro archivo.

Coloque el cursor justo encima de la llave de cierre final } en el archivo y escriba los caracteres svm (que son el acrónimo de static void Main; no se preocupe demasiado si no sabe lo que significa).

Aparece un cuadro de diálogo emergente con información sobre el fragmento de código svm.
Presione la tecla TAB dos veces para insertar el fragmento de código.

Verá cómo la firma del método static void Main() se agrega al archivo. El método Main() es el punto de entrada de las aplicaciones de C#.

Los fragmentos de código disponibles varían según el lenguaje de programación. Para ver los fragmentos de código disponibles para el lenguaje, seleccione Editar>IntelliSense>Insertar fragmento de código o presione Ctrl+K, Ctrl+X y, después, elija la carpeta del lenguaje. En C#, la lista tiene el siguiente aspecto:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

Coloque el cursor justo encima de la llave de cierre final } en el archivo y escriba los caracteres svm. svm significa static void Main, no se preocupe si no sabe lo que significa aún.

Aparece un cuadro de diálogo emergente con información sobre el fragmento de código svm.
Presione la tecla TAB dos veces para insertar el fragmento de código.

Verá cómo la firma del método static void Main() se agrega al archivo. El método Main() es el punto de entrada de las aplicaciones de C#.

Los fragmentos de código disponibles varían según el lenguaje de programación. Para ver los fragmentos de código disponibles para su lenguaje, elija Editar>IntelliSense>Insertar fragmento de código o presione Ctrl+K, Ctrl+X y, después, elija la carpeta correspondiente a su lenguaje de programación. En C#, la lista de fragmentos de código tiene el siguiente aspecto:

Screenshot of an IntelliSense pop-up for a C# code snippet list.

La lista incluye fragmentos de código para crear una clase, un constructor, un bucle for, una instrucción if o switch, etc.

Marcar código como comentario

La barra de herramientas, que es la fila de botones debajo de la barra de menús de Visual Studio, puede ayudar a mejorar la productividad mientras se codifica. Por ejemplo, puede alternar el modo de finalización de IntelliSense (IntelliSense es una ayuda de codificación que muestra una lista de métodos coincidentes, entre otras cosas), aumentar o reducir una sangría de línea o comentar el código que no quiere compilar. En esta sección se comenta algún código.

Screenshot of the Editor toolbar in Visual Studio.

Pegue el siguiente código en el cuerpo del método Main().

// _words is a string array that we'll sort alphabetically
string[] _words = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] morewords = {
    "over",
    "the",
    "lazy",
    "dog"
};

IEnumerable<string> query = from word in _words
                            orderby word.Length
                            select word;

No se usa la variable morewords, pero puede que sí se haga más adelante, así que no se elimina por completo. En su lugar, lo que haremos será convertir esas líneas en comentarios. Seleccione toda la definición de morewords hasta el punto y coma de cierre, y luego, elija el botón Comment out the selected lines (Convertir en comentario las líneas seleccionadas) en la barra de herramientas. Si prefiere usar el teclado, presione Ctrl+K, Ctrl+C.

Los caracteres de comentario de C# // se agregan al principio de cada línea seleccionada para marcar el código como comentario.

La barra de herramientas, que es la fila de botones debajo de la barra de menús de Visual Studio, ayuda a mejorar la productividad mientras se crea código. Por ejemplo, puede activar o desactivar el modo de finalización de IntelliSense, aumentar o reducir una sangría o convertir en comentario código que no se quiere compilar.

Screenshot of the Text Editor toolbar in Visual Studio 2022.

Vamos a convertir en comentario algo de código.

Pegue el siguiente código en el cuerpo del método Main().

// someWords is a string array.
string[] someWords = {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
};

string[] moreWords = {
    "over",
    "the",
    "lazy",
    "dog"
};

// Alphabetically sort the words.
IEnumerable<string> query = from word in someWords
                            orderby word
                            select word;

No vamos a usar la variable moreWords, pero puede que sí lo hagamos más adelante, así que no la eliminaremos. En su lugar, lo que haremos será convertir esas líneas en comentarios. Seleccione toda la definición de moreWords hasta el punto y coma final, y luego elija el botón Comment out the selected lines (Convertir en comentario las líneas seleccionadas) en la barra de herramientas. Si prefiere usar el teclado, presione Ctrl+K, Ctrl+C.

Los caracteres de comentario de C# // se agregan al principio de cada línea seleccionada para marcar el código como comentario.

Contraer bloques de código

Como no queremos ver el constructor vacío que se generó para Class1, vamos a contraerlo para despejar la vista del código. Seleccione el pequeño cuadro gris con el signo menos que se ve en el margen de la primera línea del constructor. O bien, si prefiere usar el teclado, coloque el cursor en cualquier lugar del código del constructor y presione CTRL+M, CTRL+M.

El bloque de código se contrae para mostrar únicamente la primera línea seguida de un botón de puntos suspensivos (...). Para expandir el bloque de código de nuevo, haga clic en el mismo cuadro gris (que ahora tiene un signo más) o presione CTRL+M, CTRL+M otra vez. Esta característica se denomina Esquematización y es especialmente útil cuando se contraen métodos muy largos o clases enteras.

El bloque de código se contrae para mostrar únicamente la primera línea seguida de un botón de puntos suspensivos (...). Para expandir de nuevo el bloque de código, seleccione el mismo cuadro gris (que ahora tiene un signo más) o presione CTRL+M, CTRL+M otra vez. Esta característica se denomina Esquematización y es especialmente útil cuando se contraen métodos muy largos o clases enteras.

Ver definiciones de símbolos

Gracias al editor de Visual Studio, es muy sencillo inspeccionar la definición de un tipo, método, etc. Una forma consiste en ir al archivo que contiene la definición, por ejemplo, seleccionando Ir a definición o presionando F12 en cualquier lugar donde se haga referencia al símbolo. Otra más rápida aún (y que no desplaza el enfoque del archivo en el que está trabajando) es usar Ver la definición. Vamos a ver la definición del tipo string.

Haga clic con el botón derecho en cualquier instancia de string y elija Ver la definición en el menú de contenido. O bien, presione Alt+F12.

Se abrirá una ventana emergente con la definición de la clase String. Puede desplazarse dentro de la ventana emergente o incluso ver la definición de otro tipo desde el código inspeccionado.
Para cerrar la ventana de definición inspeccionada, seleccione el pequeño cuadro con una "x" en la esquina superior derecha de la ventana emergente.

El editor de Visual Studio facilita la inspección de la definición de un tipo, un método o una variable. Una forma es ir a la definición, en cualquier archivo que la tenga y elegir Ir a definición o presionar F12 en cualquier lugar donde se haga referencia a un símbolo. Otra forma aún más rápida (y que no desplaza el foco del código en el que está trabajando) es usar Ver la definición.

Vamos a ver la definición del tipo string.

Haga clic con el botón derecho en cualquier instancia de string y elija Ver la definición en el menú de contenido. O bien, presione Alt+F12.

Se abrirá una ventana emergente con la definición de la clase String. Puede desplazarse dentro de la ventana emergente o incluso ver la definición de otro tipo desde el código inspeccionado.
Para cerrar la ventana Ver la definición, seleccione el pequeño cuadro con una "x" en la esquina superior derecha de la ventana emergente.

Usar IntelliSense para completar palabras

IntelliSense es un recurso impagable cuando se escribe código. Así, puede mostrar información sobre los miembros disponibles de un tipo o detalles de los parámetros para las distintas sobrecargas de un método. IntelliSense puede servir también para completar una palabra después de escribir una serie de caracteres y, así, eliminar cualquier tipo de ambigüedad. Se va a agregar una línea de código para imprimir las cadenas ordenadas en la ventana de la consola, que es el lugar estándar para la salida del programa.

Empiece a escribir el siguiente código debajo de la variable query:
```
foreach (string str in qu
```
Verá cómo IntelliSense muestra Información rápida sobre el símbolo query.
Presione Tab para insertar el resto de la palabra query por medio de la funcionalidad de finalización de palabras de IntelliSense.
Termine el bloque de código de modo que se parezca al siguiente código. Puede incluso practicar usando de nuevo fragmentos de código; para ello, escriba cw y, después, presione la tecla TAB dos veces para generar el código Console.WriteLine.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

Se va a agregar una línea de código para imprimir las cadenas ordenadas en la ventana de la consola, que es el lugar estándar para la salida del programa.

Empiece a escribir el siguiente código debajo de la variable query:
```
foreach (string str in qu
```
Verá que aparece un elemento emergente de IntelliSense con información sobre el símbolo query.
Para insertar el resto de la palabra query con la finalización de palabras de IntelliSense, presione el tabulador.
Termine el bloque de código de modo que se parezca al siguiente código. Para practicar más con los fragmentos de código, escriba cw y, luego, presione el tabulador dos veces para generar la instrucción Console.WriteLine.
```
foreach (string str in query)
{
   Console.WriteLine(str);
}
```

Refactorizar un nombre

Nadie crea código correctamente la primera vez y una de las cosas que probablemente se tengan que cambiar es el nombre de una variable o un método. Vamos a probar la funcionalidad de refactorización de Visual Studio para cambiar el nombre de la variable _words a words.

Coloque el cursor sobre la definición de la variable _words, haga clic con el botón derecho y elija Cambiar nombre en el menú contextual, o bien presione Ctrl+R, Ctrl+R.

Se abre un cuadro de diálogo emergente Cambiar nombre en la parte superior derecha del editor.
Escriba el nombre deseado, words. Observe que la referencia a words en la consulta también cambia automáticamente de nombre. Antes de presionar ENTRAR, active la casilla Incluir comentarios del cuadro emergente Cambiar nombre.
Presione ENTRAR.

Ambas instancias de words han cambiado de nombre, así como la referencia a words en el comentario de código.

Coloque el cursor sobre la definición de la variable someWords y elija Cambiar nombre en el menú contextual, o bien presione F2.

Aparece un cuadro de diálogo Cambiar nombre en la esquina superior derecha del editor.
Escriba el nombre deseado, unsortedWords. Verá que la referencia a unsortedWords en la instrucción de asignación query también cambia de nombre automáticamente. Antes de presionar ENTRAR, active la casilla Incluir comentarios del cuadro emergente Cambiar nombre.
Presione Entrar o elija Aplicar en el cuadro de diálogo Cambiar nombre.

Ambas instancias de someWords en el código han cambiado de nombre, así como el texto someWords en el comentario de código.