Instalar o .NET no WindowsInstall .NET on Windows

Neste artigo, você aprenderá a instalar o .NET no Windows.In this article, you'll learn how to install .NET on Windows. O .NET é constituído do tempo de execução e do SDK..NET is made up of the runtime and the SDK. O tempo de execução é usado para executar um aplicativo .NET e pode ou não ser incluído com o aplicativo.The runtime is used to run a .NET app and may or may not be included with the app. O SDK é usado para criar aplicativos e bibliotecas .NET.The SDK is used to create .NET apps and libraries. O tempo de execução do .NET é sempre instalado com o SDK.The .NET runtime is always installed with the SDK.

A versão mais recente do .NET é 5,0.The latest version of .NET is 5.0.

Versões com suporteSupported releases

A tabela a seguir é uma lista de versões do .NET com suporte no momento e as versões do Windows nas quais elas têm suporte.The following table is a list of currently supported .NET releases and the versions of Windows they're supported on. Essas versões permanecem com suporte até que a versão do .net atinja o fim do suporte ou a versão do Windows alcance o fim da vida útil.These versions remain supported until either the version of .NET reaches end-of-support or the version of Windows reaches end-of-life.

As datas de fim de serviço das versões do Windows 10 são segmentadas por edição.Windows 10 versions end-of-service dates are segmented by edition. Somente as edições Home, pro, pro Education e Pro for Workstations são consideradas na tabela a seguir.Only Home, Pro, Pro Education, and Pro for Workstations editions are considered in the following table. Verifique a folha de fatos do ciclo de vida do Windows para obter detalhes específicos.Check the Windows lifecycle fact sheet for specific details.

Dica

Um + símbolo representa a versão mínima.A + symbol represents the minimum version.

Sistema operacionalOperating System .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 .NET 5.NET 5
Windows 10, versão 20H2Windows 10, Version 20H2 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 2004Windows 10, Version 2004 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1909Windows 10, Version 1909 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1903Windows 10, Version 1903 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1809Windows 10, Version 1809 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1803Windows 10, Version 1803 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1709Windows 10, Version 1709 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1607Windows 10, Version 1607 ✔️✔️ ✔️✔️ ✔️✔️
Windows 8.1Windows 8.1 ✔️✔️ ✔️✔️ ✔️✔️
ESU do Windows 7 SP1Windows 7 SP1 ESU ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1607Windows 10, Version 1607 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10, versão 1607Windows 10, Version 1607 ✔️✔️ ✔️✔️ ✔️✔️
Windows Server 2012 R2Windows Server 2012 R2 ✔️✔️ ✔️✔️ ✔️✔️
Windows Server Core 2012 R2Windows Server Core 2012 R2 ✔️✔️ ✔️✔️ ✔️✔️
Nano Server, versão 1809 +Nano Server, Version 1809+ ✔️✔️ ✔️✔️ ✔️✔️
Nano Server, versão 1803Nano Server, Version 1803 ✔️✔️ ✔️✔️

Versões sem suporteUnsupported releases

Não há mais suporte para as seguintes versões do .NET ❌ .The following versions of .NET are ❌ no longer supported. Os downloads para essas versões ainda permanecem publicados:The downloads for these versions still remain published:

  • 3.03.0
  • 2.22.2
  • 2,02.0

Informações de tempo de execuçãoRuntime information

O tempo de execução é usado para executar aplicativos criados com o .NET.The runtime is used to run apps created with .NET. Quando um autor de aplicativo publica um aplicativo, ele pode incluir o tempo de execução com seu aplicativo.When an app author publishes an app, they can include the runtime with their app. Se eles não incluírem o tempo de execução, cabe ao usuário instalar o tempo de execução.If they don't include the runtime, it's up to the user to install the runtime.

Há três tempos de execução diferentes que você pode instalar no Windows:There are three different runtimes you can install on Windows:

Tempo de execução ASP.NET CoreASP.NET Core runtime
Executa ASP.NET Core aplicativos.Runs ASP.NET Core apps. Inclui o tempo de execução do .NET.Includes the .NET runtime.

Tempo de execução do desktopDesktop runtime
Executa o .NET WPF e Windows Forms aplicativos de área de trabalho para Windows.Runs .NET WPF and Windows Forms desktop apps for Windows. Inclui o tempo de execução do .NET.Includes the .NET runtime.

Tempo de execução do .NET.NET runtime
Esse tempo de execução é o tempo de execução mais simples e não inclui nenhum outro tempo de execução.This runtime is the simplest runtime and doesn't include any other runtime. É altamente recomendável que você instale o tempo de execução do ASP.NET Core e o tempo de execução da área de trabalho para obter a melhor compatibilidade com aplicativos .net.It's highly recommended that you install both ASP.NET Core runtime and Desktop runtime for the best compatibility with .NET apps.

Informações do SDKSDK information

O SDK é usado para compilar e publicar aplicativos e bibliotecas .NET.The SDK is used to build and publish .NET apps and libraries. A instalação do SDK inclui todos os três tempos de execução: ASP.NET Core, desktop e .net.Installing the SDK includes all three runtimes: ASP.NET Core, Desktop, and .NET.

DependênciasDependencies

As seguintes versões do Windows têm suporte com o .NET 5,0:The following Windows versions are supported with .NET 5.0:

Observação

Um + símbolo representa a versão mínima.A + symbol represents the minimum version.

Sistema operacionalOS VersãoVersion ArquiteturasArchitectures
Cliente do Windows 10Windows 10 Client Versão 1607+Version 1607+ x64, x86, ARM64x64, x86, ARM64
Windows ClientWindows Client 7 SP1 +, 8,17 SP1+, 8.1 x64, x86x64, x86
Windows ServerWindows Server 2012 R2 +2012 R2+ x64, x86x64, x86
Núcleo do Windows ServerWindows Server Core 2012 R2 +2012 R2+ x64, x86x64, x86
Nano ServerNano Server Versão 1809 +Version 1809+ x64x64

Para obter mais informações sobre OS sistemas operacionais, as distribuições e a política de ciclo de vida com suporte do .NET 5,0, consulte versões do sistema operacional .net 5,0 com suporte.For more information about .NET 5.0 supported operating systems, distributions, and lifecycle policy, see .NET 5.0 Supported OS Versions.

Windows 7/Vista/8,1/servidor 2008 R2/Server 2012 R2Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

Mais dependências serão necessárias se você estiver instalando o SDK do .NET ou o tempo de execução nas seguintes versões do Windows:More dependencies are required if you're installing the .NET SDK or runtime on the following Windows versions:

Sistema operacionalOperating System Pré-requisitosPrerequisites
ESU do Windows 7 SP1Windows 7 SP1 ESU -Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit- Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
-KB3063858 64bits / 32-bit- KB3063858 64-bit / 32-bit
- Microsoft Root Certification Authority 2011 (somente instalador offline do .net Core 2,1)- Microsoft Root Certificate Authority 2011 (.NET Core 2.1 offline installer only)
Windows Vista SP 2Windows Vista SP 2 Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bitMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows 8.1Windows 8.1 Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bitMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2008 R2Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bitMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012 R2Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bitMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit

Os requisitos anteriores também serão necessários se você receber um erro relacionado a qualquer uma das seguintes DLLs:The previous requirements are also required if you receive an error related to either of the following dlls:

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

Instalar com a automação do PowerShellInstall with PowerShell automation

Os scripts dotnet-install são usados para a automação CI e para instalações não administrativas do tempo de execução.The dotnet-install scripts are used for CI automation and non-admin installs of the runtime. Você pode baixar o script na página de referência de script dotnet-install.You can download the script from the dotnet-install script reference page.

O script assume como padrão a instalação da versão mais recente do LTS (suporte a longo prazo) , que é o .net Core 3,1.The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. Você pode escolher uma versão específica especificando a Channel opção.You can choose a specific release by specifying the Channel switch. Inclua a Runtime opção para instalar um tempo de execução.Include the Runtime switch to install a runtime. Caso contrário, o script instalará o SDK.Otherwise, the script installs the SDK.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

Instale o SDK omitindo a -Runtime opção.Install the SDK by omitting the -Runtime switch. A -Channel opção é definida neste exemplo como Current , que instala a versão mais recente com suporte.The -Channel switch is set in this example to Current, which installs the latest supported version.

dotnet-install.ps1 -Channel Current

Instalar com o Visual StudioInstall with Visual Studio

Se você estiver usando o Visual Studio para desenvolver aplicativos .NET, a tabela a seguir descreve a versão mínima necessária do Visual Studio com base na versão do SDK do .NET de destino.If you're using Visual Studio to develop .NET apps, the following table describes the minimum required version of Visual Studio based on the target .NET SDK version.

Versão do SDK do .NET.NET SDK version Versão do Visual StudioVisual Studio version
5.05.0 Visual Studio 2019 versão 16,8 ou superior.Visual Studio 2019 version 16.8 or higher.
3.13.1 Visual Studio 2019 versão 16,4 ou superior.Visual Studio 2019 version 16.4 or higher.
3.03.0 Visual Studio 2019 versão 16,3 ou superior.Visual Studio 2019 version 16.3 or higher.
2.22.2 Visual Studio 2017 versão 15,9 ou superior.Visual Studio 2017 version 15.9 or higher.
2.12.1 Visual Studio 2017 versão 15,7 ou superior.Visual Studio 2017 version 15.7 or higher.

Se você já tiver o Visual Studio instalado, poderá verificar sua versão com as etapas a seguir.If you already have Visual Studio installed, you can check your version with the following steps.

  1. Abra o Visual Studio.Open Visual Studio.
  2. Selecione ajuda > sobre Microsoft Visual Studio.Select Help > About Microsoft Visual Studio.
  3. Leia o número de versão na caixa de diálogo sobre .Read the version number from the About dialog.

O Visual Studio pode instalar o SDK e o tempo de execução do .NET mais recentes.Visual Studio can install the latest .NET SDK and runtime.

Selecionar uma carga de trabalhoSelect a workload

Ao instalar ou modificar o Visual Studio, selecione uma ou mais das cargas de trabalho a seguir, dependendo do tipo de aplicativo que você está criando:When installing or modifying Visual Studio, select one or more of the following workloads, depending on the kind of application you're building:

  • A carga de trabalho de desenvolvimento de plataforma cruzada do .NET Core na seção outros conjuntos de ferramentas .The .NET Core cross-platform development workload in the Other Toolsets section.
  • A carga de trabalho de desenvolvimento da Web e ASP.net na seção Web & nuvem .The ASP.NET and web development workload in the Web & Cloud section.
  • A carga de trabalho de desenvolvimento do Azure na seção Web & nuvem .The Azure development workload in the Web & Cloud section.
  • A carga de trabalho .net desktop Development na seção Desktop & Mobile .The .NET desktop development workload in the Desktop & Mobile section.

Carga de trabalho do Windows Visual Studio 2019 com .NET CoreWindows Visual Studio 2019 with .NET Core workload

Instalar junto com Visual Studio CodeInstall alongside Visual Studio Code

Visual Studio Code é um editor de código-fonte leve e avançado que é executado em sua área de trabalho.Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code está disponível para Windows, macOS e Linux.Visual Studio Code is available for Windows, macOS, and Linux.

Embora Visual Studio Code não venha com um instalador .NET Core automatizado como o Visual Studio, adicionar o suporte ao .NET Core é simples.While Visual Studio Code doesn't come with an automated .NET Core installer like Visual Studio does, adding .NET Core support is simple.

  1. Baixe e instale o Visual Studio Code.Download and install Visual Studio Code.
  2. Baixe e instale o SDK do .NET Core.Download and install the .NET Core SDK.
  3. Instale a extensão C# do Visual Studio Code Marketplace.Install the C# extension from the Visual Studio Code marketplace.

Windows InstallerWindows Installer

A página de download do .net fornece Windows Installer executáveis.The download page for .NET provides Windows Installer executables.

Ao usar os instaladores do Windows para instalar o .NET, você pode personalizar o caminho de instalação definindo DOTNETHOME_X64 os DOTNETHOME_X86 parâmetros e:When you use the Windows installers to install .NET, you can customize the installation path by setting the DOTNETHOME_X64 and DOTNETHOME_X86 parameters:

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

Se você quiser instalar o .NET silenciosamente, como em um ambiente de produção ou para oferecer suporte à integração contínua, use as seguintes opções:If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following switches:

  • /install
    Instala o .NET.Installs .NET.

  • /quiet
    Impede que qualquer interface do usuário e prompts sejam exibidos.Prevents any UI and prompts from displaying.

  • norestart
    Suprime todas as tentativas de reinicialização.Suppresses any attempts to restart.

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

Para obter mais informações, consulte Opções do Command-Line do instalador padrão.For more information, see Standard Installer Command-Line Options.

Dica

O instalador retorna um código de saída 0 para êxito e um código de saída de 3010 para indicar que uma reinicialização é necessária.The installer returns an exit code of 0 for success and an exit code of 3010 to indicate that a restart is required. Qualquer outro valor é geralmente um código de erro.Any other value is generally an error code.

Baixar e instalar manualmenteDownload and manually install

Como alternativa para os instaladores do Windows para .NET, você pode baixar e instalar manualmente o SDK ou o tempo de execução.As an alternative to the Windows installers for .NET, you can download and manually install the SDK or runtime. A instalação manual normalmente é feita como parte do teste de integração contínua.Manual install is usually done as part of continuous integration testing. Para um desenvolvedor ou usuário, geralmente é melhor usar um instalador.For a developer or user, it's generally better to use an installer.

Tanto o SDK do .NET quanto o tempo de execução do .NET podem ser instalados manualmente após terem sido baixados.Both .NET SDK and .NET Runtime can be manually installed after they've been downloaded. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente.If you install .NET SDK, you don't need to install the corresponding runtime. Primeiro, Baixe uma versão binária para o SDK ou o tempo de execução de um dos seguintes sites:First, download a binary release for either the SDK or the runtime from one of the following sites:

Crie um diretório para extrair o .NET, por exemplo %USERPROFILE%\dotnet .Create a directory to extract .NET to, for example %USERPROFILE%\dotnet. Em seguida, extraia o arquivo zip baixado para esse diretório.Then, extract the downloaded zip file into that directory.

Por padrão, os comandos e aplicativos da CLI do .NET não usarão o .NET instalado dessa forma e você deverá optar por usá-lo explicitamente.By default, .NET CLI commands and apps won't use .NET installed in this way and you must explicitly choose to use it. Para fazer isso, altere as variáveis de ambiente com as quais um aplicativo é iniciado:To do so, change the environment variables with which an application is started:

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

Essa abordagem permite que você instale várias versões em locais separados e escolha explicitamente qual local de instalação um aplicativo deve usar executando o aplicativo com variáveis de ambiente apontando para esse local.This approach lets you install multiple versions into separate locations, then explicitly choose which install location an application should use by running the application with environment variables pointing at that location.

Quando DOTNET_MULTILEVEL_LOOKUP é definido como 0 , o .net ignora qualquer versão do .net instalada globalmente.When DOTNET_MULTILEVEL_LOOKUP is set to 0, .NET ignores any globally installed .NET version. Remova essa configuração de ambiente para permitir que o .NET considere o local de instalação global padrão ao selecionar a melhor estrutura para executar o aplicativo.Remove that environment setting to let .NET consider the default global install location when selecting the best framework for running the application. O padrão é normalmente C:\Program Files\dotnet , que é onde os instaladores instalam o .net.The default is typically C:\Program Files\dotnet, which is where the installers install .NET.

DockerDocker

Os contêineres fornecem uma maneira leve de isolar seu aplicativo do restante do sistema host.Containers provide a lightweight way to isolate your application from the rest of the host system. Os contêineres no mesmo computador compartilham apenas o kernel e usam os recursos fornecidos ao seu aplicativo.Containers on the same machine share just the kernel and use resources given to your application.

O .NET pode ser executado em um contêiner do Docker..NET can run in a Docker container. As imagens oficiais do Docker do .NET são publicadas no MCR (registro de contêiner da Microsoft) e podem ser descobertas no repositório do Microsoft .net Docker Hub.Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Docker Hub repository. Cada repositório contém imagens para diferentes combinações do .NET (SDK ou Runtime) e do sistema operacional que você pode usar.Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.

A Microsoft fornece imagens personalizadas para cenários específicos.Microsoft provides images that are tailored for specific scenarios. Por exemplo, o repositório do ASP.NET Core fornece imagens que são criadas para a execução de aplicativos ASP.NET Core na produção.For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.

Para obter mais informações sobre como usar o .NET em um contêiner do Docker, consulte introdução ao .net e ao Docker e amostras.For more information about using .NET in a Docker container, see Introduction to .NET and Docker and Samples.

Próximas etapasNext steps