Procedimiento Ejecución de un programa de C# en Visual Studio

El procedimiento para ejecutar un programa depende del punto de partida, del tipo de programa y de si quiere que se ejecute en el depurador. En el caso más sencillo, para compilar y ejecutar un proyecto abierto en Visual Studio, debe hacer lo siguiente:

  • Presione F5, elija Depurar > Iniciar con depuración en el menú de Visual Studio o seleccione la flecha Iniciar de color verde y el nombre del proyecto en la barra de herramientas de Visual Studio.
  • O bien, para ejecutar sin depuración, presione CTRL+F5 o elija Depurar > Iniciar sin depuración en el menú de Visual Studio.

Captura de pantalla en la que se muestra el botón Iniciar.

Captura de pantalla en la que se muestra el botón Iniciar.

Inicio a partir de un proyecto

Puede ejecutar un proyecto de C# o un archivo .csproj si es un programa ejecutable. Si un proyecto contiene un archivo de C# con un método Main y su resultado es un ejecutable o .exe, lo más probable es que se ejecute si se compila correctamente.

  1. Si el código del programa ya se encuentra en un proyecto de Visual Studio, abra dicho proyecto. Para ello, puede hacer doble clic o pulsar en el archivo .csproj en el Explorador de archivos de Windows, o bien elegir Open a project (Abrir un proyecto) en Visual Studio, buscar el archivo .csproj y seleccionarlo.

  2. Una vez que el proyecto se carga en Visual Studio, si la solución de Visual Studio contiene más de un proyecto, asegúrese de establecer el que tiene el método Main como proyecto de inicio. Para establecer el proyecto de inicio, haga clic con el botón derecho en el nombre o nodo del proyecto en el Explorador de soluciones y elija Establecer como proyecto de inicio en el menú contextual.

    Captura de pantalla en la que se muestra cómo establecer el proyecto de inicio.

    Captura de pantalla en la que se muestra cómo establecer el proyecto de inicio.

  3. Para ejecutar el programa, presione CTRL+F5, seleccione Depurar > Iniciar sin depuración en el menú superior o seleccione el botón Iniciar de color verde.

    Visual Studio intenta compilar y ejecutar el proyecto. En la parte inferior de la pantalla de Visual Studio, aparece la salida de compilación en la ventana Salida, mientras que los errores de compilación aparecen en la ventana Lista de errores.

    Si la compilación se realiza correctamente, la aplicación se ejecuta de la forma adecuada para el tipo de proyecto. Las aplicaciones de consola se ejecutan en una ventana de terminal, las de escritorio de Windows se inician en una ventana de escritorio nueva y las aplicaciones web se ejecutan en un explorador hospedado por IIS Express.

Inicio a partir de código

Si empieza a partir de un listado de código, un archivo de código o un número reducido de archivos, asegúrese primero de que el código sea un programa ejecutable procedente de un origen de confianza. Cualquier aplicación con un método Main es probablemente un programa ejecutable. Puede usar la plantilla Aplicación de consola con el fin de crear un proyecto para trabajar con la aplicación en Visual Studio.

Listado de código para un solo archivo

  1. Inicie Visual Studio y abra un proyecto de aplicación de consola de C# vacío.
  2. Reemplace todo el código del archivo .cs del proyecto por el contenido de la lista de código o el archivo.
  3. Cambie el nombre del archivo .cs del proyecto de modo que coincida con el nombre del archivo de código.

Varias listas de código o archivos en disco

  1. Inicie Visual Studio y cree un proyecto del tipo adecuado. Use la aplicación de consola de C# si no está seguro.
  2. En el nuevo proyecto, reemplace todo el código del archivo de código del proyecto por el contenido del primer archivo o lista de código.
  3. Cambie el nombre del archivo de código del proyecto de modo que coincida con el nombre del archivo de código.
  4. Para cada archivo de código restante:
    1. Haga clic con el botón derecho en el nodo del proyecto en el Explorador de soluciones y elija Agregar > Elemento existente, o bien seleccione el proyecto y presione Mayús+Alt+A.
    2. Vaya al archivo de código y selecciónelo para importarlo en el proyecto.

Varios archivos en una carpeta

Si tiene una carpeta con muchos archivos, primero compruebe si hay un archivo de proyecto o solución. Los programas que crea Visual Studio tienen archivos de proyecto y solución. En el Explorador de archivos de Windows, busque archivos con la extensión .csproj o .sln. Haga doble clic en el archivo .csproj para abrirlo en Visual Studio. Vea Inicio a partir de una solución o un proyecto de Visual Studio.

Si el código es de otro entorno de desarrollo, no hay ningún archivo de proyecto. Abra la carpeta mediante Abrir > Carpeta en Visual Studio. Vea Desarrollo de código sin proyectos o soluciones.

Inicio a partir de un repositorio de GitHub o Azure DevOps

Si el código que quiere ejecutar está en un repositorio de GitHub o Azure DevOps, puede usar Visual Studio para abrir el proyecto directamente desde el repositorio. Vea Apertura de un proyecto desde un repositorio.

Ejecutar el programa

Para empezar a compilar el programa, presione el botón Iniciar de color verde de la barra de herramientas de Visual Studio, o bien presione F5 o CTRL+F5. Mediante el uso del botón Iniciar o F5, el programa se ejecuta en el depurador.

Visual Studio intenta compilar y ejecutar el código del proyecto. Si una compilación no se realiza correctamente, consulte las secciones siguientes para obtener algunas ideas sobre cómo hacer que el proyecto se compile correctamente.

Solución de problemas

El código podría tener errores. También podría ser correcto, pero depender de ensamblados o paquetes NuGet que faltan, o bien tener como destino una versión diferente de .NET. En esos casos, es posible que pueda corregir fácilmente la compilación.

Agregar referencias

Para que se compile de la forma adecuada, el código debe ser correcto y tener las referencias adecuadas en bibliotecas u otras dependencias. Los subrayados ondulados de color rojo en el código o las entradas de la lista de errores muestran los errores incluso antes de que el programa se compile y se ejecute. Si los errores están relacionados con nombres no resueltos, es probable que tenga agregar una referencia o una directiva using, o ambas. Si el código hace referencia a ensamblados o paquetes NuGet que faltan, tendrá que agregar esas referencias al proyecto.

Visual Studio intenta ayudarle a identificar las referencias que faltan. Cuando hay un nombre sin resolver, aparece un icono de bombilla en el editor. Seleccione la bombilla para ver sugerencias sobre cómo corregir el problema. Las correcciones pueden ser las siguientes:

  • Incorporación de una directiva using
  • Incorporación de una referencia a un ensamblado
  • Instalación de un paquete NuGet

Incorporación de una directiva using

Este es un ejemplo de una directiva using que falta. Puede agregar using System; al inicio del archivo de código para resolver el nombre Console no resuelto:

Captura de pantalla de la bombilla para agregar una directiva using.

Captura de pantalla de la bombilla para agregar una directiva using.

Incorporación de una referencia a un ensamblado

Las referencias de .NET pueden ser ensamblados o paquetes NuGet. En el código fuente, el publicador o el autor suelen explicar qué ensamblados requiere el código y de qué paquetes depende. Para agregar una referencia a un proyecto manualmente, haga clic con el botón derecho en el nodo Referencias del Explorador de soluciones y elija Agregar referencia. En el Administrador de referencias, busque y agregue el ensamblado necesario.

Captura de pantalla del menú Agregar referencia.

Captura de pantalla del menú Agregar referencia.

Puede buscar ensamblados y agregar referencias si sigue las instrucciones indicadas en Adición o eliminación de referencias con el Administrador de referencias.

Adición de un paquete NuGet

Si Visual Studio detecta que falta un paquete NuGet, aparece una bombilla y le ofrece la opción de instalarlo:

Captura de pantalla de la bombilla para instalar un paquete NuGet.

Captura de pantalla de la bombilla para instalar un paquete NuGet.

Si eso no soluciona el problema o si Visual Studio no encuentra el paquete, intente buscarlo en línea. Vea Instalación y uso de un paquete NuGet en Visual Studio.

Uso de la versión correcta de .NET

Como las distintas versiones de .NET Framework tienen cierto grado de compatibilidad con versiones anteriores, un marco de trabajo más reciente podría ejecutar código escrito para un marco anterior sin necesidad de realizar cambios. Aun así, en ocasiones es necesario establecer como destino una versión específica de .NET Framework. Es posible que tenga que instalar una versión específica de .NET Framework o .NET Core. Vea Modificación de Visual Studio.

Para cambiar la versión de destino de .NET Framework, vea Cambio del marco de destino. Para más información, vea Solución de problemas de versión de .NET Framework de destino.

Pasos siguientes