Inicio rápido: uso de Visual Studio para crear su primera aplicación web ASP.NET Core

En esta introducción de entre cinco y diez minutos sobre el uso de Visual Studio, se crea una aplicación web sencilla "Hello World" mediante una plantilla de proyecto de ASP.NET y el lenguaje de programación C#.

Antes de empezar

Instalación de Visual Studio

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

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

Elija su tema (opcional)

En esta guía de inicio rápido se incluyen capturas de pantalla que utilizan el tema oscuro. Si no va a usar el tema oscuro, pero le gustaría saber cómo hacerlo, consulte Personalización del IDE y el editor de Visual Studio.

Crear un proyecto

En primer lugar, creará un proyecto de aplicación web ASP.NET Core. En el tipo de proyecto se incluyen todos los archivos de plantilla para crear una aplicación web, sin necesidad de agregar nada más.

  1. Abra Visual Studio 2017.

  2. En la barra de menús superior, elija Archivo > Nuevo > Proyecto.

  3. En el panel izquierdo del cuadro de diálogo Nuevo proyecto, expanda Visual C# y luego elija .NET Core. En el panel central, elija Aplicación web ASP.NET Core.

    Luego nombre al archivo HelloWorld y haga clic en Aceptar.

    Creación de un proyecto de aplicación web ASP.NET Core para C#

    Nota

    Si no ve la categoría de plantilla de proyecto de .NET Core, elija el vínculo Abrir el instalador de Visual Studio en el panel de la izquierda. (Según la configuración de pantalla, es posible que tenga que desplazarse para verlo).

    Abrir el Instalador de Visual Studio desde el cuadro de diálogo Nuevo proyecto

    Se iniciará el Instalador de Visual Studio. Elija la carga de trabajo Desarrollo de ASP.NET y web y después haga clic en Modificar.

    Carga de trabajo ASP.NET en el instalador de Visual Studio

    (Es posible que deba cerrar Visual Studio para continuar con la instalación de la carga de trabajo nueva).

  4. En el cuadro de diálogo Nueva aplicación web ASP.NET Core, seleccione ASP.NET Core 2.1 en el menú desplegable situado en la parte superior. Después, elija Aplicación web y luego haga clic en Aceptar.

    Cuadro de diálogo Nueva aplicación web ASP.NET Core

    Nota

    Si no ve ASP.NET Core 2.1, asegúrese de que se está ejecutando la versión más reciente de Visual Studio. Para obtener más información sobre cómo actualizar la instalación, vea la página Actualización de Visual Studio a la versión más reciente.

Poco después, Visual Studio abre el archivo de proyecto.

  1. En la ventana de inicio, elija Crear un nuevo proyecto.

    Captura de pantalla que muestra la ventana de inicio de Visual Studio con la opción "Crear un nuevo proyecto" resaltada.

  2. En la ventana Crear un nuevo proyecto, elija C# en la lista Idioma. A continuación, seleccione Windows en la lista Plataforma y Web en la lista Tipos de proyecto.

    Después de aplicar los filtros de lenguaje, plataforma y tipo de proyecto, elija la plantilla Aplicación web ASP.NET Core y, luego, Siguiente.

    Captura de pantalla que muestra la ventana "Crear un nuevo proyecto" filtrada por "C#", "Windows" y "Web", y la plantilla de proyecto de aplicación web de ASP.NET Core resaltada.

    Nota

    Si no ve la plantilla Aplicación web ASP.NET Core, puede instalarla desde la ventana Crear un nuevo proyecto. En el mensaje ¿No encuentra lo que busca? , elija el vínculo Instalar más herramientas y características.

    Captura de pantalla que muestra el vínculo "Instalar más herramientas y características" resaltado en el mensaje "¿No encuentra lo que busca?"

    Luego, en el Instalador de Visual Studio, elija la carga de trabajo Desarrollo de ASP.NET y web.

    Captura de pantalla que muestra la carga de trabajo de desarrollo multiplataforma de .NET Core en el Instalador de Visual Studio.

    Después, elija el botón Modificar en el Instalador de Visual Studio. Si se le pide que guarde su trabajo, hágalo. Seguidamente, elija Continuar para instalar la carga de trabajo. Luego, vuelva al paso 2 de este procedimiento "Crear un proyecto".

  3. En la ventana Configurar el nuevo proyecto, escriba HelloWorld en el cuadro Nombre del proyecto. Después, elija Siguiente.

    Captura de pantalla que muestra la ventana "Configurar el nuevo proyecto" con "HelloWorld" escrito en el campo Nombre del proyecto.

  4. En la ventana Información adicional, compruebe que .NET Core 3.1 aparece en el menú desplegable superior. Tenga en cuenta que puede habilitar la compatibilidad con Docker activando la casilla. También puede agregar compatibilidad con la autenticación, para lo que debe hacer clic en el botón Cambiar autenticación. Ahí, puede elegir entre las siguientes opciones:

    • Ninguna: sin autenticación.
    • Cuentas individuales: se almacenan en una base de datos local o basada en Azure.
    • Plataforma de identidad de Microsoft: esta opción usa Active Directory, Azure AD o Microsoft 365 para la autenticación.
    • Windows: conveniente para las aplicaciones de intranet.

    Deje desactivada la casilla Habilitar Docker y seleccione Ninguno en Tipo de autenticación. Seleccione Crear.

    Captura de pantalla que muestra la ventana "Información adicional" con ".NET Core 3.1" seleccionado en el campo "Marco".

    Visual Studio abrirá el nuevo proyecto.

  1. En la ventana de inicio, elija Crear un nuevo proyecto.

    Captura de pantalla que muestra la ventana de inicio de Visual Studio con la opción "Crear un nuevo proyecto" resaltada.

  2. En la ventana Crear un nuevo proyecto, elija C# en la lista Idioma. A continuación, seleccione Windows en la lista Plataforma y Web en la lista Tipos de proyecto.

    Después de aplicar los filtros de lenguaje, plataforma y tipo de proyecto, elija la plantilla Aplicación web ASP.NET Core y, luego, Siguiente.

    Captura de pantalla que muestra la ventana "Crear un nuevo proyecto" filtrada por "C#", "Windows" y "Web", y la plantilla de proyecto de aplicación web de ASP.NET Core resaltada.

    Nota

    Si no ve la plantilla Aplicación web ASP.NET Core, puede instalarla desde la ventana Crear un nuevo proyecto. En el mensaje ¿No encuentra lo que busca? , elija el vínculo Instalar más herramientas y características.

    Captura de pantalla que muestra el vínculo "Instalar más herramientas y características" resaltado en el mensaje "¿No encuentra lo que busca?"

    Luego, en el Instalador de Visual Studio, elija la carga de trabajo Desarrollo de ASP.NET y web.

    Captura de pantalla que muestra la carga de trabajo de desarrollo multiplataforma de .NET Core en el Instalador de Visual Studio.

    Después, elija el botón Modificar en el Instalador de Visual Studio. Si se le pide que guarde su trabajo, hágalo. Seguidamente, elija Continuar para instalar la carga de trabajo. Luego, vuelva al paso 2 de este procedimiento "Crear un proyecto".

  3. En la ventana Configurar el nuevo proyecto, escriba HelloWorld en el cuadro Nombre del proyecto. Después, elija Siguiente.

    Captura de pantalla que muestra la ventana "Configurar el nuevo proyecto" con "HelloWorld" escrito en el campo Nombre del proyecto.

  4. En la ventana Información adicional, compruebe que .NET 6.0 aparece en el campo Marco. Tenga en cuenta que puede habilitar la compatibilidad con Docker activando la casilla. También puede agregar compatibilidad con la autenticación si selecciona un valor en la lista desplegable Tipo de autenticación. Ahí, puede elegir entre las siguientes opciones:

    • Ninguna: sin autenticación.
    • Cuentas individuales: estas autenticaciones se almacenan en una base de datos local o basada en Azure.
    • Plataforma de identidad de Microsoft: esta opción usa Active Directory, Azure AD o Microsoft 365 para la autenticación.
    • Windows: conveniente para las aplicaciones de intranet.

    Deje desactivada la casilla Habilitar Docker y seleccione Ninguno como tipo de autenticación. Seleccione Crear.

    Captura de pantalla que muestra la ventana "Información adicional" con ".NET 6.0" seleccionado en el campo "Marco".

    Visual Studio abrirá el nuevo proyecto.

Crear y ejecutar la aplicación

  1. En el Explorador de soluciones, expanda la carpeta Páginas y después elija About.cshtml.

    Captura de pantalla del Explorador de soluciones de Visual Studio en la que se muestran los archivos del proyecto HelloWorld. La carpeta Pages está expandida con About.cshtml seleccionado.

    Este archivo corresponde a una página denominada Acerca de en la aplicación web y que se ejecuta en un explorador web.

    Página Acerca de de la aplicación web

    En el editor, verá el código HTML para el área "información adicional" de la página Acerca de.

    El código HTML para el área de información adicional en el editor de Visual Studio

  2. Cambie el texto "información adicional" para que rece "Hello World!".

    Cambio del código HTML predeterminado para el área de información adicional en el editor de Visual Studio

  3. En el Explorador de soluciones, expanda About.cshtml y luego elija About.cshtml.cs. (Este archivo también se corresponde con la página Acerca de en un explorador web).

    Captura de pantalla del Explorador de soluciones de Visual Studio en la que se muestran los archivos del proyecto HelloWorld. About.cshtml está expandido con About.cshtml.cs seleccionado.

    En el editor, verá el código de C# que incluye texto para el área "Descripción de la aplicación" de la página Acerca de.

    El código de C# para el área de descripción de la aplicación en el editor de Visual Studio

  4. Cambie el texto del mensaje "descripción de la aplicación" para que rece "¿Cuál es mi mensaje?".

    Cambio del texto del mensaje predeterminado para el área de descripción de la aplicación en el editor de Visual Studio

  5. Seleccione IIS Express o presione Ctrl+F5 para ejecutar la aplicación y abrirla en un explorador web.

    Haga clic en el botón IIS Express de Visual Studio

    Nota

    Si recibe un mensaje de error que dice No se puede conectar al servidor web "IIS Express" o un mensaje de error que menciona un certificado SSL, cierre Visual Studio. Después, abra Visual Studio mediante la opción Ejecutar como administrador del menú contextual. A continuación, vuelva a ejecutar la aplicación.

  6. En el explorador web, compruebe que la página Acerca de incluye el texto actualizado.

    Visualización de la página Acerca de actualizada que incluye los cambios realizados

  7. Cierre el explorador web.

Revisión del trabajo

Vea la animación siguiente para comprobar el trabajo que ha realizado en la sección anterior.

Vista del archivo .gif animado en el que se muestra cómo crear y ejecutar una sencilla aplicación web ASP.NET Core de C# en Visual Studio

¡Enhorabuena por completar este tutorial de inicio rápido! Esperamos que haya aprendido algo sobre C#, ASP.NET Core y el IDE (entorno de desarrollo integrado) de Visual Studio.

  1. En el Explorador de soluciones, expanda la carpeta Páginas y, después, elija Index.cshtml.

    Captura de pantalla que muestra "Index.cshtml" seleccionado dentro de la carpeta "Páginas" expandida en el Explorador de soluciones.

    Este archivo corresponde a una página denominada Inicio en la aplicación web y que se ejecuta en un explorador web.

    Captura de pantalla que muestra la página principal de la aplicación web en la ventana del explorador.

    En el editor, verá código HTML para el texto que se muestra en la página Inicio.

    Captura de pantalla que muestra el archivo Index.cshtml en la página principal del editor de código de Visual Studio.

  2. Cambie el texto "Le damos la bienvenida" por "Hola mundo".

    Captura de pantalla que muestra el archivo "Index.cshtml" en el editor de código de Visual Studio con el texto de bienvenida cambiado a "Hola mundo".

  3. Seleccione IIS Express o presione Ctrl+F5 para ejecutar la aplicación y abrirla en un explorador web.

    Captura de pantalla que muestra el botón IIS Express resaltado en Visual Studio.

    Nota

    Si recibe un mensaje de error que dice No se puede conectar al servidor web "IIS Express" o un mensaje de error que menciona un certificado SSL, cierre Visual Studio. Después, abra Visual Studio mediante la opción Ejecutar como administrador del menú contextual. A continuación, vuelva a ejecutar la aplicación.

  4. En el explorador web, compruebe que la página Inicio incluya el texto actualizado.

    Captura de pantalla que muestra la página principal de la aplicación web en la ventana del explorador con el mensaje actualizado "Hola mundo".

  5. Cierre el explorador web.

  1. En el Explorador de soluciones, expanda la carpeta Páginas y, después, elija Index.cshtml.

    Captura de pantalla que muestra "Index.cshtml" seleccionado dentro de la carpeta "Páginas" expandida en el Explorador de soluciones.

    Este archivo corresponde a una página denominada Inicio en la aplicación web y que se ejecuta en un explorador web.

    Captura de pantalla que muestra la página principal de la aplicación web en la ventana del explorador.

    En el editor, verá código HTML para el texto que se muestra en la página Inicio.

    Captura de pantalla que muestra el archivo Index.cshtml en la página principal del editor de código de Visual Studio.

  2. Cambie el texto "Le damos la bienvenida" por "Hola mundo".

    Captura de pantalla que muestra el archivo "Index.cshtml" en el editor de código de Visual Studio con el texto de bienvenida cambiado a "Hola mundo" .

  3. Seleccione IIS Express o presione Ctrl+F5 para ejecutar la aplicación y abrirla en un explorador web.

    Captura de pantalla que muestra el botón IIS Express resaltado en Visual Studio.

    Nota

    Si recibe un mensaje de error que dice No se puede conectar al servidor web "IIS Express" o un mensaje de error que menciona un certificado SSL, cierre Visual Studio. Después, abra Visual Studio mediante la opción Ejecutar como administrador del menú contextual. A continuación, vuelva a ejecutar la aplicación.

  4. En el explorador web, compruebe que la página Inicio incluya el texto actualizado.

    Captura de pantalla que muestra la página principal de la aplicación web en la ventana del explorador con el mensaje actualizado "Hola mundo".

  5. Cierre el explorador web.

Pasos siguientes

Para obtener más información sobre la creación de aplicaciones web de ASP.NET, continúe con el tutorial siguiente:

Si lo prefiere, puede aprender a contenedorizar la aplicación web con Docker:

Vea también

Publicar una aplicación web en Azure App Service mediante Visual Studio