Tutorial: Creación de una aplicación de consola de .NET con Visual Studio Code

  • Artículo
  • 3 minutos para leer

En este tutorial se muestra cómo crear y ejecutar una aplicación de consola de .NET mediante Visual Studio Code y la CLI de .NET. Las tareas de proyecto, como crear, compilar y ejecutar un proyecto, se realizan mediante la CLI de .NET. Puede seguir este tutorial con un editor de código diferente y ejecutar comandos en un terminal si lo prefiere.

Requisitos previos

Creación de la aplicación

Cree un proyecto de aplicación de consola de .NET denominado "HelloWorld".

  1. Inicie Visual Studio Code.

  2. Seleccione Archivo > Abrir carpeta (Archivo > Abrir... en macOS) en el menú principal.

  3. En el cuadro de diálogo Abrir carpeta, cree una carpeta HelloWorld y selecciónela. A continuación, haga clic en Seleccionar carpeta (Abrir en macOS).

    De forma predeterminada, el nombre de la carpeta se convierte en el nombre del proyecto y del espacio de nombres. Más adelante en el tutorial, agregará código que supone que el espacio de nombres del proyecto es HelloWorld.

  4. En el cuadro de diálogo ¿Confía en los autores de los archivos de esta carpeta? , seleccione Yes, I trust the authors (Sí, confío en los autores).

  5. Para abrir el Terminal en Visual Studio Code, seleccione Ver > Terminal en el menú principal.

    Se abre el Terminal con el símbolo del sistema en la carpeta HelloWorld.

  6. En el Terminal, escriba este comando:

    dotnet new console --framework net6.0

    La plantilla de proyecto crea una aplicación sencilla que muestra "Hola mundo" en la ventana de consola al llamar al método Console.WriteLine(String) en Program.cs.

    Console.WriteLine("Hello, World!");

  7. Reemplace el contenido de Program.cs por el código siguiente:

    namespace HelloWorld
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}

    Seleccione Sí en caso de que Visual Studio Code le pida que agregue los recursos que faltan para compilar y depurar la aplicación.

    El código define una clase, Program, con un solo método, Main, que toma una matriz de String como argumento. Main es el punto de entrada de la aplicación, el método que se llama automáticamente mediante el tiempo de ejecución cuando inicia la aplicación. Los argumentos de línea de comandos proporcionados cuando se inicia la aplicación están disponibles en la matriz args.

    En la versión más reciente de C#, una nueva característica denominada instrucciones de nivel superior permite omitir la clase Program y el método Main. La mayoría de los programas de C# existentes no usan instrucciones de nivel superior, por lo que en este tutorial no se usa esta nueva característica. Pero está disponible en C# 10 y si se usa en los programas es una cuestión de preferencia de estilo.

Ejecutar la aplicación

Ejecute este comando en el Terminal:

dotnet run

El programa muestra "Hola mundo" y finaliza.

El comando de ejecución de dotnet

Mejora de la aplicación

Mejore la aplicación para pedir su nombre al usuario y mostrarlo con la fecha y la hora.

  1. Abra Program.cs.

  2. Reemplace el contenido del método Main en Program.cs, que es la línea que llama a Console.WriteLine, por este código:

    Console.WriteLine("What is your name?");
var name = Console.ReadLine();
var currentDate = DateTime.Now;
Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
Console.Write($"{Environment.NewLine}Press any key to exit...");
Console.ReadKey(true);

    Este código muestra un mensaje en la ventana de la consola y espera a que el usuario escriba una cadena y, luego, presione Entrar. Almacena esta cadena en una variable denominada name. También recupera el valor de la propiedad DateTime.Now, que contiene la hora local actual, y lo asigna a una variable denominada currentDate. Asimismo, muestra estos valores en la ventana de la consola. Por último, muestra un mensaje en la ventana de la consola y llama al método Console.ReadKey(Boolean) para esperar a la entrada del usuario.

    NewLine es una manera independiente de la plataforma y del lenguaje de representar un salto de línea. Las alternativas son \n en C# y vbCrLf en Visual Basic.

    El signo de dólar ($) delante de una cadena permite colocar expresiones como nombres de variable entre llaves en la cadena. El valor de la expresión se inserta en la cadena en lugar de la expresión. Esta sintaxis se conoce como cadenas interpoladas.

  3. Guarde los cambios.

    Importante

    En Visual Studio Code, tiene que guardar los cambios explícitamente. A diferencia de Visual Studio, los cambios de los archivos no se guardan automáticamente al compilar y ejecutar una aplicación.

  4. Ejecute el programa otra vez:

    dotnet run

  5. Responda a la solicitud escribiendo un nombre y presionando la tecla Entrar.

    Ventana del Terminal con el resultado del programa modificado

  6. Presione cualquier tecla para salir de la aplicación.

Recursos adicionales

Pasos siguientes

En este tutorial, ha creado una aplicación de consola de .NET. En el siguiente tutorial, depurará la aplicación.

Depuración de una aplicación de consola de .NET con Visual Studio Code

En este tutorial se muestra cómo crear y ejecutar una aplicación de consola de .NET mediante Visual Studio Code y la CLI de .NET. Las tareas de proyecto, como crear, compilar y ejecutar un proyecto, se realizan mediante la CLI de .NET. Puede seguir este tutorial con un editor de código diferente y ejecutar comandos en un terminal si lo prefiere.

Requisitos previos

  1. Visual Studio Code con la extensión de C# instalada. Para saber cómo instalar extensiones en Visual Studio Code, vea el Marketplace de extensiones de VS Code.
  2. El SDK de .NET 5. Si instala el SDK de .NET 6, instale también el SDK de .NET 5; de lo contrario, algunas de las instrucciones del tutorial no funcionarán. Para obtener más información, consulte Las nuevas plantillas de C# generan instrucciones de nivel superior.

Creación de la aplicación

Cree un proyecto de aplicación de consola de .NET denominado "HelloWorld".

  1. Inicie Visual Studio Code.

  2. Seleccione Archivo > Abrir carpeta (Archivo > Abrir... en macOS) en el menú principal.

  3. En el cuadro de diálogo Abrir carpeta, cree una carpeta de HelloWorld y haga clic en Seleccionar carpeta (Abrir en macOS).

    De forma predeterminada, el nombre de la carpeta se convierte en el nombre del proyecto y del espacio de nombres. Más adelante en el tutorial, agregará código que supone que el espacio de nombres del proyecto es HelloWorld.

  4. Para abrir el Terminal en Visual Studio Code, seleccione Ver > Terminal en el menú principal.

    Se abre el Terminal con el símbolo del sistema en la carpeta HelloWorld.

  5. En el Terminal, escriba este comando:

    dotnet new console --framework net5.0

La plantilla crea una aplicación "Hola mundo" sencilla. Llama al método Console.WriteLine(String) para mostrar "Hello World!" en la ventana de la consola.

El código de plantilla define una clase, Program, con un solo método, Main, que toma una matriz de String como argumento:

using System;

namespace HelloWorld
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}

Main es el punto de entrada de la aplicación, el método que se llama automáticamente mediante el tiempo de ejecución cuando inicia la aplicación. Los argumentos de línea de comandos proporcionados cuando se inicia la aplicación están disponibles en la matriz args.

Ejecutar la aplicación

Ejecute este comando en el Terminal:

dotnet run

El programa muestra "Hola mundo" y finaliza.

El comando de ejecución de dotnet

Mejora de la aplicación

Mejore la aplicación para pedir su nombre al usuario y mostrarlo con la fecha y la hora.

  1. Haga clic en el archivo Program.cs para abrirlo.

    La primera vez que se abre un archivo de C# en Visual Studio Code, se carga OmniSharp en el editor.

    Abrir el archivo Program.cs

  2. Seleccione Sí cuando Visual Studio Code le pida que agregue los recursos que faltan para compilar y depurar la aplicación.

    Solicitud de los recursos que faltan

  3. Reemplace el contenido del método Main en Program.cs, que es la línea que llama a Console.WriteLine, por este código:

    Console.WriteLine("What is your name?");
var name = Console.ReadLine();
var currentDate = DateTime.Now;
Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
Console.Write($"{Environment.NewLine}Press any key to exit...");
Console.ReadKey(true);

    Este código muestra un mensaje en la ventana de la consola y espera a que el usuario escriba una cadena y, luego, presione Entrar. Almacena esta cadena en una variable denominada name. También recupera el valor de la propiedad DateTime.Now, que contiene la hora local actual, y lo asigna a una variable denominada currentDate. Asimismo, muestra estos valores en la ventana de la consola. Por último, muestra un mensaje en la ventana de la consola y llama al método Console.ReadKey(Boolean) para esperar a la entrada del usuario.

    NewLine es una manera independiente de la plataforma y del lenguaje de representar un salto de línea. Las alternativas son \n en C# y vbCrLf en Visual Basic.

    El signo de dólar ($) delante de una cadena permite colocar expresiones como nombres de variable entre llaves en la cadena. El valor de la expresión se inserta en la cadena en lugar de la expresión. Esta sintaxis se conoce como cadenas interpoladas.

  4. Guarde los cambios.

    Importante

    En Visual Studio Code, tiene que guardar los cambios explícitamente. A diferencia de Visual Studio, los cambios de los archivos no se guardan automáticamente al compilar y ejecutar una aplicación.

  5. Ejecute el programa otra vez:

    dotnet run

  6. Responda a la solicitud escribiendo un nombre y presionando la tecla Entrar.

    Ventana del Terminal con el resultado del programa modificado

  7. Presione cualquier tecla para salir de la aplicación.

Recursos adicionales

Pasos siguientes

En este tutorial, ha creado una aplicación de consola de .NET. En el siguiente tutorial, depurará la aplicación.

Depuración de una aplicación de consola de .NET con Visual Studio Code

Este tutorial solo está disponible para .NET 5 y .NET 6. Seleccione una de esas opciones en la parte superior de la página.