Instalar .NET no Windows

Este artigo ensina quais versões de .NET têm suporte em Windows, como instalar .NET e qual é a diferença entre o SDK e o runtime.

Ao contrário do .NET Framework, .NET não está vinculado à sua versão do Windows. Você só pode ter uma única versão do .NET Framework instalada no Windows. Mas .NET é autônomo e pode ser instalado em qualquer lugar no computador. Alguns aplicativos podem incluir sua própria cópia de .NET.

Por padrão, .NET é instalado no diretório Program Files\dotnet em seu computador, a menos que o método de instalação escolha um diretório diferente.

.NET é composto pelo runtime e pelo SDK. O runtime executa aplicativos .NET, e o SDK é utilizado para criar aplicativos.

Escolha o runtime correto

Há três runtimes diferentes para Windows, que permitem a execução de diferentes tipos de aplicativos. O SDK inclui todos os três tempos de execução, e um instalador para um tempo de execução pode incluir um tempo de execução adicional. A tabela a seguir descreve qual tempo de execução está incluído com um instalador específico de .NET:

Para garantir que você possa executar todos os aplicativos .NET no Windows, instale o ASP.NET Core Runtime e o .NET Desktop Runtime. O ASP.NET Core Runtime executa aplicativos baseados na Web e o .NET Desktop Runtime executa aplicativos da área de trabalho, como um aplicativo Windows Presentation Foundation (WPF) ou Windows Forms.

Escolha como instalar .NET

Há diferentes maneiras de instalar .NET e alguns produtos podem gerenciar sua própria versão do .NET. Se você instalar .NET por meio de software que gerencia sua própria versão do .NET, ele pode não estar habilitado em todo o sistema. Entenda as implicações da instalação de .NET por meio de outros softwares.

Se você não tiver certeza de qual método deve escolher depois de revisar as listas nas seções a seguir, provavelmente deseja usar o .NET Installer.

Desenvolvedores

• Visual Studio

  Use Visual Studio para instalar .NET quando quiser desenvolver aplicativos .NET usando Visual Studio. Visual Studio gerencia sua própria cópia de .NET. Esse método instala os modelos de SDK, Runtime e Visual Studio.

• Visual Studio Code – Kit de Desenvolvimento em C#

  Instale a extensão C# Dev Kit para o Visual Studio Code para desenvolver aplicativos .NET. A extensão pode usar um SDK que já esteja instalado ou instalar um para você.

Usuários e desenvolvedores

• .NET Installer

  Instale .NET com um pacote Windows Installer, que é um executável que você executa. Esse método pode instalar o SDK e o Runtime. As instalações são executadas em todo o sistema.

• Windows Package Manager (WinGet)

  Use WinGet para instalar .NET quando quiser gerenciar .NET por meio da linha de comando. Esse método pode instalar o SDK e o Runtime. As instalações são executadas em todo o sistema.

• PowerShell

  Um script do PowerShell que pode automatizar a instalação do SDK ou do Runtime. Você pode escolher qual versão do .NET instalar.

Versões suportadas

A tabela a seguir é uma lista de versões de .NET com suporte no momento e as versões de Windows em que há suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a versão do Windows atinja o fim da vida útil.

Windows 10 - as datas de término de serviço das versões são organizadas por edição. Somente as edições Home, Pro, Pro Education e Pro for Workstations são consideradas na tabela a seguir. Verifique a folha de informações do ciclo de vida do Windows para obter detalhes específicos.

Windows 7/8.1/Server 2012

Não há mais uma versão de .NET com suporte em Windows 7 e Windows 8.1. As últimas versões com suporte foram .NET 6 e o suporte terminou em 12 de novembro de 2024.

Windows Server 2012 ainda é compatível com qualquer versão de .NET que ainda esteja em suporte.

Todas essas três versões de Windows exigem que outras dependências sejam instaladas:

Os requisitos anteriores também serão necessários se você receber um erro relacionado a qualquer uma das seguintes dlls:

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

PCs com arquitetura ARM executando Windows

.NET tem suporte em computadores Windows baseados em Arm. As seções a seguir descrevem as coisas que você deve considerar ao instalar .NET.

Diferenças de caminho

Em um computador Windows baseado em Arm, todas as versões do Arm64 do .NET são instaladas na pasta C:\Program Files\dotnet\. No entanto, a versão x64 do SDK do .NET é instalada na pasta C:\Program Files\dotnet\x64\.

Variáveis de caminho

Variáveis de ambiente que adicionam .NET ao caminho do sistema, como a variável PATH, talvez precisem ser alteradas se você tiver as versões x64 e Arm64 do SDK .NET instaladas. Além disso, algumas ferramentas dependem da variável de ambiente DOTNET_ROOT, que também precisaria ser atualizada para apontar para a pasta de instalação do SDK .NET apropriada.

Instalar com Visual Studio

Visual Studio instala sua própria cópia de .NET separada de outras cópias de .NET. Diferentes versões de Visual Studio dão suporte a diferentes versões de .NET. A versão mais recente do Visual Studio sempre dá suporte à versão mais recente do .NET.

Visual Studio Installer instala e configura Visual Studio. Algumas cargas de trabalho do Visual Studio incluem .NET, como ASP.NET e desenvolvimento na Web e desenvolvimento de interface do usuário de aplicativo multiplataforma .NET. Versões específicas do .NET podem ser instaladas por meio da guia Individual Components.

A documentação do Visual Studio fornece instruções sobre como:

• Instalar Visual Studio.
• Configurar cargas de trabalho Visual Studio.

captura de tela

.NET versões e Visual Studio

Se você estiver usando Visual Studio para desenvolver aplicativos .NET, a tabela a seguir descreve a versão mínima necessária de Visual Studio com base na versão do SDK de .NET de destino.

Se você já tiver Visual Studio instalado, poderá verificar sua versão com as etapas a seguir.

1. Abra Visual Studio.
2. Selecione Help>About Microsoft Visual Studio.
3. Leia o número da versão na caixa de diálogos Sobre.

Para obter mais informações sobre, consulte .NET SDK, MSBuild e Visual Studio controle de versão.

Instalar com Visual Studio Code

Visual Studio Code é um editor de código-fonte poderoso e leve que é executado em sua área de trabalho. Visual Studio Code pode usar o SDK já instalado em seu sistema.

Este arquivo de configuração WinGet instala o mais recente .NET SDK, Visual Studio Code e o DevKit do C#. Se você já tiver qualquer um deles instalado, o WinGet ignorará essa etapa.

1. Baixe o arquivo e clique duas vezes para executá-lo.
2. Leia o contrato de licença, digite ye selecione Enter quando solicitado a aceitar.
3. Se você receber um prompt de UAC (Controle de Conta de Usuário) piscando na barra de tarefas, permita que a instalação continue.

Além disso, a extensão C# Dev Kit instalará .NET se ainda não estiver instalada.

Para obter instruções sobre como instalar .NET por meio de Visual Studio Code, consulte Getting Started with C# in VS Code.

instalador .NET

A página de download para .NET fornece executáveis do Windows Installer.

1. Abra um navegador da Web e navegue até https://dotnethttps://dotnet.microsoft.com/download/dotnet.

2. Selecione a versão do .NET que você deseja baixar, como 10.0.

3. Localize a caixa SDK ou Runtime que contém os links para baixar .NET.

4. Na coluna Installers, localize a linha Windows e selecione o link para sua arquitetura de CPU. Se você não tiver certeza, selecione x64, pois é o mais comum.

   O navegador deve baixar automaticamente o instalador.

   Dica

   A imagem a seguir mostra o SDK, mas você também pode baixar o Runtime.

   

5. Abra Windows Explorer e navegue até onde o arquivo foi baixado, provavelmente sua pasta Downloads.

6. Clique duas vezes no arquivo para instalar .NET.

   A caixa de diálogo Windows Instalador está aberta.

   Uma captura de tela da janela do aplicativo instalador .NET.

7. Selecione Instalar e siga as instruções para instalar .NET.

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Opções de linha de comando

Use o parâmetro /? para exibir uma lista de opções.

Se você quiser instalar .NET silenciosamente, como em um ambiente de produção ou para dar suporte à integração contínua, use as seguintes opções:

• /install
  Instala .NET.

• /quiet
  Impede que qualquer interface do usuário e solicitações sejam exibidos.

• /norestart
  Suprime todas as tentativas de reinicialização.

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

Se você já tiver instalado .NET, use o instalador de .NET para gerenciar a instalação. Em vez de /install, você pode usar uma das seguintes opções:

• /uninstall
  Remova esta versão do .NET.

• /repair
  Verifique se os principais arquivos ou componentes das instalações estão danificados e restaure-os.

Microsoft Update

Os executáveis do instalador .NET são produtos independentes que podem ser atendidos usando o Microsoft Update (MU) no Windows. O MU é diferente do WU (Windows Update), que é usado para atender componentes do sistema operacional, como .NET Framework.

As correções de segurança e não de segurança para versões com suporte de .NET são fornecidas por meio do MU usando vários canais de distribuição. As Atualizações Automáticas (AU) são relevantes para usuários finais e consumidores, enquanto os Serviços de Atualização do Windows Server (WSUS) e Windows Update Catalog são relevantes para os administradores de TI.

Os executáveis do instalador .NET dão suporte a instalações SxS (lado a lado) em versões principais e secundárias para diferentes arquiteturas e componentes, como o runtime e o SDK. Por exemplo, você pode instalar o runtime 6.0.15 (x64) e 6.0.17 (x86). Quando o MU for acionado, ele oferecerá o instalador mais recente para ambas as instalações.

Bloquear atualizações

Embora a maioria dos usuários prefira ser mantida atualizada, é possível bloquear .NET atualizações usando as chaves do Registro na tabela a seguir.

Atualizações automáticas para o sistema operacional do servidor

As atualizações para sistemas operacionais de servidor são compatíveis com o WSUS e o Catálogo do Microsoft Update, mas não com o AU. Os sistemas operacionais de servidor podem optar por receber atualizações por meio do AU usando as seguintes chaves do Registro.

WSUS e classificações de atualizações

O WSUS pode ser configurado para fornecer atualizações específicas com base em sua classificação. As atualizações de .NET são classificadas como security ou critical. Se a atualização mais recente for classificada como crítica, uma atualização security mais antiga poderá ser oferecida quando uma versão mais antiga do .NET for instalada substituída pela atualização de segurança mais recente. Isso também se aplica ao uso do CAB offline (Wsusscan2.cab) para verificar um computador.

Escolha quando as versões anteriores são removidas

Os executáveis do instalador sempre instalam o novo conteúdo antes de remover a instalação anterior. Os aplicativos em execução podem ser interrompidos ou travar quando os tempos de execução mais antigos são removidos. Para minimizar o impacto da atualização .NET, você pode especificar quando uma instalação de .NET anterior deve ser removida usando uma chave do Registro.

• never retém instalações anteriores e requer intervenção manual para remover instalações de .NET anteriores.
• always remove instalações anteriores após a instalação da nova versão. Esse é o comportamento padrão em .NET.
• nextSession adia a remoção até a próxima sessão de logon dos membros do grupo Administradores.
• Os valores não diferenciam maiúsculas de minúsculas e os valores inválidos são padronizados para always.

Quando a remoção é adiada, o instalador grava um comando na chave do Registro RunOnce para desinstalar a versão anterior. O comando só será executado se um usuário no grupo Administradores fizer logon na máquina.

Instalar com Windows Package Manager (WinGet)

Você pode instalar e gerenciar .NET por meio do serviço Windows Package Manager, usando a ferramenta winget.exe. Para obter mais informações sobre como instalar e usar o WinGet, consulte Usar a ferramenta winget para instalar e gerenciar aplicativos.

Os pacotes do WinGet .NET são:

• Microsoft.DotNet.Runtime.10 — .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10 — ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10 — .NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10 — .NET SDK 10.0
• Microsoft.DotNet.Runtime.9 — .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9 — ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9 — .NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9 — .NET SDK 9.0
• Microsoft.DotNet.Runtime.8 — .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8 — ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8 — .NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8 — .NET SDK 8.0

Instalar o SDK

Se você instalar o SDK, não será necessário instalar o runtime equivalente.

1. Instale o WinGet.

2. Abra um terminal, como o PowerShell ou o Prompt de Comando.

3. Execute o comando winget install e passe o nome do pacote do SDK:

   winget install Microsoft.DotNet.SDK.10
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

Há diferentes runtimes que você pode instalar. Consulte a seção Escolher o runtime correto para entender o que está incluído em cada runtime.

1. Instale o WinGet.

2. Abra um terminal, como o PowerShell ou o Prompt de Comando.

3. Execute o comando winget install e passe o nome do pacote do SDK:

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Pesquisar versões

Use o comando winget search para pesquisar versões diferentes do pacote que você deseja instalar. Por exemplo, o comando a seguir pesquisa todos os SDKs de .NET disponíveis por meio do WinGet:

winget search Microsoft.DotNet.SDK

Os resultados da pesquisa são impressos em uma tabela com cada identificador de pacote.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Instalar versões prévias

Se uma versão prévia estiver disponível, substitua o número da versão no Id pela palavra Preview. O exemplo a seguir instala a versão prévia do .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalar com o PowerShell

A instalação de .NET por meio do script dotnet-install do PowerShell é recomendada para instalações de integração contínua e não administrador. Se você estiver instalando .NET para uso normal em seu sistema, use os métodos de instalação .NET Installer ou Windows Package Manager.

O script padroniza a instalação da versão mais recente de suporte de longo prazo (LTS), que é o .NET 10. Você pode escolher uma versão específica definindo a opção -Channel . Inclua a opção -Runtime para instalar um runtime. Caso contrário, o script instala o SDK. O script está disponível em https://dot.net/v1/dotnet-install.ps1 e o código-fonte é hospedado em GitHub.

Para obter mais informações sobre o script, consulte dotnet-referência do script de instalação.

Instalar o runtime

O .NET Runtime é instalado fornecendo a opção -Runtime.

1. Baixar o script de instalação de https://dot.net/v1/dotnet-install.ps1

2. Abra o PowerShell e navegue até a pasta que contém o script.

3. Execute os seguintes comandos para instalar ambos os runtimes: o da área de trabalho e o do ASP.NET Core, garantindo a máxima compatibilidade.

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o SDK

Se você instalar o SDK, não será necessário instalar os runtimes.

1. Baixar o script de instalação de https://dot.net/v1/dotnet-install.ps1

2. Abra o PowerShell e navegue até a pasta que contém o script.

3. Execute o comando a seguir para instalar o SDK do .NET.

   dotnet-install.ps1
   

   Observação

   O SDK é instalado omitindo a opção -Runtime .

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Validação

Depois de fazer o download de um instalador ou de uma versão binária, verifique se o arquivo não foi alterado ou corrompido. Você pode verificar o checksum no seu computador e depois compará-lo com o que foi relatado no site de download.

Quando você baixa o arquivo de uma página oficial de download, a soma de verificação do arquivo é exibida em uma caixa de texto. Selecione o botão Copiar a fim de copiar o valor de soma de verificação para a área de transferência.

Você pode usar o PowerShell ou o prompt de comando para validar a soma de verificação do arquivo baixado. Por exemplo, o comando a seguir informa a soma de verificação do arquivo dotnet-sdk-9.0.306-win-x64.exe:

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

Compare a soma de verificação com o valor fornecido pelo site de download.

Usar o PowerShell e um arquivo de soma de verificação para validação

As notas de versão .NET contêm um link para um arquivo de soma de verificação que você pode usar para validar o arquivo baixado. As etapas a seguir descrevem como baixar o arquivo de soma de verificação e validar um binário de instalação .NET:

1. A página de notas de versão do .NET 9 no GitHub em https://github.com/dotnet/core/tree/main/release-notes/9.0 contém uma seção chamada Releases. A tabela nesta seção contém links para os downloads e arquivos de soma de verificação de cada versão do .NET 9. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

   

2. Selecione o link para a versão do .NET que você baixou. A seção anterior usou .NET SDK 9.0.306, que está na versão .NET 9.0.10.

   Dica

   Se você não tiver certeza de qual versão .NET contém o arquivo de soma de verificação, explore os links até encontrá-lo.

3. Na página de versão, você pode ver o .NET Runtime e a versão do .NET SDK, e um link para o arquivo de checksum. A imagem a seguir mostra a tabela de lançamento do .NET 8 como referência:

   

4. Copie o link do arquivo de soma de verificação.

5. Use o script a seguir, mas substitua o link para baixar o arquivo de soma de verificação apropriado:

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. Com o arquivo de soma de verificação e o arquivo de versão .NET baixado no mesmo diretório, pesquise no arquivo de soma de verificação a soma de verificação do download do .NET:

   Quando a validação for aprovada, você verá True impresso:

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Se False for exibido, o arquivo que você baixou não é válido e não deve ser usado.

Solução de problemas

Depois de instalar o SDK do .NET, você pode encontrar problemas ao tentar executar comandos da CLI .NET. Esta seção coleta esses problemas comuns e fornece soluções.

• No .NET SDK foi encontrado
• A criação de aplicativos está mais lenta do que o esperado
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll está ausente

Nenhum SDK .NET foi encontrado

Provavelmente você instalou as versões x86 (32 bits) e x64 (64 bits) do SDK do .NET. Isso está causando um conflito porque, quando você executa o comando dotnet, ele está sendo resolvido para a versão x86 quando deveria resolver para a versão x64. Esse problema é corrigido ajustando a variável %PATH% para resolver a versão x64 primeiro.

1. Verifique se você tem as duas versões instaladas executando o comando where.exe dotnet. Se você fizer isso, deverá encontrar uma entrada para as pastas Program Files\ e Program Files (x86)\. Se a pasta Program Files (x86)\ estiver em primeiro lugar, como mostrado no exemplo a seguir, isso estará incorreto e você deverá prosseguir para a próxima etapa.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Dica

   Embora Program Files seja usado neste exemplo, você poderá ver outras cópias de dotnet.exe listadas. Ajuste-os para que o dotnet.exe apropriado seja resolvido primeiro.

   Se estiver correto e Program Files\ for o primeiro, você não terá o problema que esta seção está discutindo e você deve criar um problema de solicitação de ajuda .NET no GitHub.

2. Pressione o botão Windows e digite "Editar as variáveis de ambiente do sistema" na pesquisa. Selecione Editar as variáveis de ambiente do sistema.

   

3. A janela Propriedades do Sistema é aberta para a guia Avançado. Selecione Variáveis de Ambiente.

   

4. Na janela Variáveis de Ambiente, no grupo variáveis do sistema , selecione a linha Caminho* e, em seguida, o botão Editar .

   

5. Use os botões Mover para Cima e Mover para Baixo para mover a entrada C:\Program Files\dotnet\ acima de C:\Program Files (x86)\dotnet\.

   

A criação de aplicativos está mais lenta do que o esperado

Verifique se o Controle inteligente de aplicativos, um recurso de Windows, está desativado. Não é recomendável habilitar o Controle de Aplicativo Inteligente em computadores usados para desenvolvimento. Qualquer configuração diferente de "off" pode impactar negativamente o desempenho do SDK.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll está ausente

Instale o Pacote Redistribuível do Microsoft Visual C++ 2015-2019 (64 bits ou 32 bits).

Conteúdo relacionado

• .NET CLI visão geral
• Upgrade para uma nova versão .NET.
• Como verificar se .NET já está instalado.
• Tutorial: Criar um novo aplicativo de console.