Instalación de .NET en Windows

En este artículo obtendrá información sobre cómo instalar .NET en Windows. .NET está formado por el entorno de ejecución y el SDK. El entorno de ejecución se usa para ejecutar una aplicación de .NET, y puede o no incluirse con la aplicación. El SDK se usa para crear aplicaciones y bibliotecas de .NET. El entorno de ejecución de .NET siempre se instala con el SDK.

La versión más reciente de .NET es la 5.0.

Versiones compatibles

En la tabla siguiente se muestra una lista de versiones de .NET actualmente compatibles y las versiones de Windows en las que se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llega al fin del soporte técnico o la versión de Windows llega al final del ciclo de vida.

Las fechas de fin de servicio de Windows 10 están segmentadas por edición. En la tabla que hay a continuación solo se tienen en cuenta las ediciones Home, Pro, Pro Education y Pro for Workstations. Para ver detalles específicos, consulte la hoja informativa sobre el ciclo de vida de Windows.

Versiones no admitidas

Las versiones siguientes de .NET ya ❌ no se admiten. aunque sus descargas siguen estando publicadas:

• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Información en tiempo de ejecución

El entorno de ejecución se usa para ejecutar aplicaciones creadas con .NET. Cuando un autor publica una aplicación, puede incluir el tiempo de ejecución. Si no lo hace, el usuario elige si quiere instalar el tiempo de ejecución.

Hay tres entornos de ejecución distintos que se pueden instalar en Windows:

• Entorno de ejecución de ASP.NET Core
  Ejecuta aplicaciones de ASP.NET Core. Incluye el entorno de ejecución de .NET.

• Entorno de ejecución de escritorio
  Ejecuta aplicaciones de escritorio WPF y Windows Forms de .NET para Windows. Incluye el entorno de ejecución de .NET.

• Entorno de ejecución de .NET
  Este entorno de ejecución es el más sencillo y no incluye ningún otro. Se recomienda encarecidamente instalar el entorno de ejecución de ASP.NET Core y el entorno de ejecución de escritorio para conseguir la mejor compatibilidad con las aplicaciones de .NET.

Información del SDK

El SDK se usa para compilar y publicar aplicaciones y bibliotecas de .NET. La instalación del SDK incluye los tres entornos de ejecución: el de ASP.NET Core, el de escritorio y el de .NET.

Dependencias

certmgr.exe /add MicRooCerAut2011_2011_03_22.crt /s /r localMachine root

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

Se necesitan más dependencias en caso de que se instale el SDK o el entorno de ejecución de .NET en las versiones siguientes de Windows:

Los requisitos anteriores también son necesarios si se encuentra con un error relacionado con uno de los archivos DLL siguientes:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Instalación mediante la automatización de PowerShell

Los scripts de dotnet-install se usan para la automatización de CI y las instalaciones que no son de administrador del entorno de ejecución. Se puede descargar el script desde la página de referencia del script dotnet-install.

El valor predeterminado del script es instalar la versión más reciente de soporte técnico a largo plazo (LTS), que actualmente es .NET Core 3.1. Puede elegir una versión concreta especificando el modificador Channel. Incluya el modificador Runtime para instalar un entorno de ejecución. De lo contrario, el script instala el SDK.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

Instale el SDK omitiendo el modificador -Runtime. El modificador -Channel de este ejemplo está establecido en Current, con lo que se instala la versión admitida más reciente.

dotnet-install.ps1 -Channel Current

Instalación con Visual Studio

Si usa Visual Studio para desarrollar aplicaciones de .NET, en la tabla siguiente se describe la versión mínima necesaria de Visual Studio, en función de la versión del SDK de .NET de destino.

Si ya tiene Visual Studio instalado, puede comprobar la versión siguiendo los pasos que se detallan a continuación.

1. Abra Visual Studio.
2. Seleccione Ayuda > Acerca de Microsoft Visual Studio.
3. Lea el número de versión en el cuadro de diálogo Acerca de.

Visual Studio puede instalar el SDK y el entorno de ejecución de .NET más recientes.

Selección de una carga de trabajo

Al instalar o modificar Visual Studio, seleccione una de las cargas de trabajo siguientes o más, en función del tipo de aplicación que quiera compilar:

• La carga de trabajo Desarrollo multiplataforma de .NET Core en la sección Otros conjuntos de herramientas.
• La carga de trabajo Desarrollo de ASP.NET y web en la sección Web y nube.
• La carga de trabajo Desarrollo de Azure en la sección Web y nube.
• La carga de trabajo Desarrollo de escritorio de .NET en la sección Móviles y de escritorio.

Instalación junto con Visual Studio Code

Visual Studio Code es un editor de código fuente ligero y eficaz que se ejecuta en el escritorio. Visual Studio Code está disponible para Windows, macOS y Linux.

Aunque Visual Studio Code no viene con un instalador automatizado de .NET Core como Visual Studio, agregar compatibilidad con .NET Core es sencillo.

1. Descargue e instale Visual Studio Code.
2. Descargue e instale el SDK de .NET.
3. Instale la extensión de C# desde el Marketplace de Visual Studio Code.

Windows Installer

La página de descarga de .NET proporciona ejecutables de Windows Installer.

Al usar los instaladores de Windows para instalar .NET, puede personalizar la ruta de instalación estableciendo los parámetros DOTNETHOME_X64 y DOTNETHOME_X86:

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

Si quiere instalar .NET de forma silenciosa, como en un entorno de producción o para admitir la integración continua, use las expresiones switch siguientes:

• /install
  Instala .NET.

• /quiet
  Impide que se muestren interfaces de usuario y solicitudes.

• norestart
  Suprime los intentos de reinicio.

dotnet-sdk-3.1.301-win-x64.exe /install /quiet /norestart

Para obtener más información, vea Opciones de la línea de comandos del instalador estándar.

Descarga e instalación de forma manual

Como alternativa a los instaladores de Windows para .NET, puede descargar e instalar manualmente el SDK o el entorno de ejecución. La instalación manual se suele realizar durante las pruebas de integración continua. Para un desarrollador o usuario, generalmente es mejor usar un instalador.

Tanto el SDK como el entorno de ejecución de .NET se pueden instalar manualmente una vez que se han descargado. Si instala el SDK de .NET, no necesita instalar el entorno de ejecución correspondiente. En primer lugar, descargue una versión binaria del SDK o del entorno de ejecución de uno de los siguientes sitios:

• Descargas de .NET 5
• Descargas de .NET Core 3.1
• Todas las descargas de .NET Core

Cree un directorio en el que se extraerá .NET; por ejemplo, %USERPROFILE%\dotnet. Después, extraiga el archivo ZIP descargado en ese directorio.

De forma predeterminada, los comandos y las aplicaciones de la CLI de .NET no usarán la versión de .NET instalada de esta manera y debe elegir explícitamente usarla. Para ello, cambie las variables de entorno con las que se inicia una aplicación:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Este enfoque permite instalar varias versiones en ubicaciones independientes y elegir explícitamente qué ubicación de instalación debe usar una aplicación mediante la ejecución de la aplicación con variables de entorno que apuntan a esa ubicación.

Cuando DOTNET_MULTILEVEL_LOOKUP se establece en 0, .NET ignora cualquier versión de .NET instalada de forma global. Elimine esa configuración de entorno para que .NET tenga en cuenta la ubicación de instalación global predeterminada al seleccionar el mejor marco para ejecutar la aplicación. La ubicación predeterminada suele ser C:\Program Files\dotnet, en la que los instaladores instalan .NET.

Docker

Los contenedores proporcionan una manera ligera de aislar la aplicación del resto del sistema host. Los contenedores de la misma máquina comparten solo el kernel y usan los recursos proporcionados a la aplicación.

.NET se puede ejecutar en un contenedor de Docker. Las imágenes oficiales de Docker en .NET se publican en el registro de contenedor de Microsoft (MCR) y se pueden encontrar en el repositorio de Docker Hub para Microsoft .NET. Cada repositorio contiene imágenes para diferentes combinaciones de .NET (SDK o Runtime) y del sistema operativo que puede usar.

Microsoft ofrece imágenes que se adaptan a escenarios específicos. Por ejemplo, el repositorio de ASP.NET Core proporciona imágenes que se compilan para ejecutar aplicaciones de ASP.NET Core en producción.

Para obtener más información sobre el uso de .NET en un contenedor de Docker, vea Introducción a .NET y Docker y Ejemplos.

Pasos siguientes

• Procedimiento para comprobar que .NET ya está instalado.
• Tutorial: Tutorial Hola mundo.
• Tutorial: Creación de una aplicación con Visual Studio Code.
• Tutorial: Inclusión de una aplicación de .NET Core en un contenedor.