Determinar quais versões do .NET Framework estão instaladas - .NET Framework (2023)

Os usuários podeminstalare executam várias versões do .NET Framework em seus computadores. Ao desenvolver ou implantar seu aplicativo, talvez seja necessário saber quais versões do .NET Framework estão instaladas no computador do usuário. O registro contém uma lista das versões do .NET Framework instaladas no computador.

O .NET Framework consiste em dois componentes principais, com versões separadas:

• Um conjunto de assemblies, que são coleções de tipos e recursos que fornecem a funcionalidade para seus aplicativos. O .NET Framework e os assemblies compartilham o mesmo número de versão. Por exemplo, as versões do .NET Framework incluem 4.5, 4.6.1 e 4.7.2.

• O Common Language Runtime (CLR), que gerencia e executa o código do seu aplicativo. Uma única versão do CLR geralmente dá suporte a várias versões do .NET Framework. Por exemplo, CLR versão 4.0.30319.xxxxxondexxxxxé menor que 42000, oferece suporte às versões 4 a 4.5.2 do .NET Framework. A versão CLR maior ou igual a 4.0.30319.42000 oferece suporte a versões do .NET Framework começando com .NET Framework 4.6.

Ferramentas mantidas pela comunidade estão disponíveis para ajudar a detectar quais versões do .NET Framework estão instaladas:

• https://github.com/jmalarcon/DotNetVersions

  Uma ferramenta de linha de comando do .NET Framework 2.0.

• https://github.com/EliteLoser/DotNetVersionLister

  Um módulo do PowerShell 2.0.

Para obter informações sobre como detectar as atualizações instaladas para cada versão do .NET Framework, consulteComo: determinar quais atualizações do .NET Framework estão instaladas.

Determine em qual implementação e versão do .NET um aplicativo está sendo executado

Você pode usar oRuntimeInformation.FrameworkDescriptionpropriedade para consultar em qual implementação e versão do .NET seu aplicativo está sendo executado. Se o aplicativo estiver em execução no .NET Framework, a saída será semelhante a:

.NET Framework 4.8.4250.0

Por comparação, se o aplicativo estiver em execução no .NET Core ou .NET 5+, a saída será semelhante a:

.NET Core 3.1.9.NET 5.0.0

Detectar .NET Framework 4.5 e versões posteriores

A versão do .NET Framework (4.5 e posterior) instalada em uma máquina está listada no registro emHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full. Se oCompletosubchave está faltando, então o .NET Framework 4.5 ou superior não está instalado.

OLiberarO valor REG_DWORD no registro representa a versão do .NET Framework instalada.

Versão mínima

Para determinar se ummínimoversão do .NET Framework estiver presente, verifique se háLiberarValor REG_DWORD maior ou igual ao valor correspondente listado na tabela a seguir. Por exemplo, se seu aplicativo for executado no .NET Framework 4.8 ou em uma versão posterior, teste umaLiberarValor REG_DWORD que éMelhor que ou igual a528040.

Usar o Editor do Registro

1. DeComeçarmenu, escolhaCorrer, digitarregedite, em seguida, selecioneOK.

   (Você deve ter credenciais administrativas para executar o regedit.)

2. No Editor do Registro, abra a seguinte subchave:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full. Se oCompletosubchave não estiver presente, então você não tem o .NET Framework 4.5 ou posterior instalado.

3. Verifique se há uma entrada REG_DWORD chamadaLiberar. Se existir, você tem o .NET Framework 4.5 ou posterior instalado. Seu valor corresponde a uma versão específica do .NET Framework. Na figura a seguir, por exemplo, o valor doLiberarentrada é 528040, que é a chave de lançamento do .NET Framework 4.8.

   

Use o PowerShell para verificar uma versão mínima

Use os comandos do PowerShell para verificar o valor doLiberarentrada doHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Fullunge-me.

Os exemplos a seguir verificam o valor doLiberarpara determinar se o .NET Framework 4.6.2 ou posterior está instalado. Este código retornaVerdadeirose estiver instalado eFalsode outra forma.

(Get-ItemPropertyValue -LiteralPath 'HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full' -Name Release) -ge 394802

Consultar o registro usando código

1. Use oRegistryKey.OpenBaseKeyeRegistryKey.OpenSubKeymétodos para acessar oHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Fullsubchave no registro do Windows.

   Importante

   Se o aplicativo que você está executando for de 32 bits e executado no Windows de 64 bits, os caminhos do registro serão diferentes dos listados anteriormente. O registro de 64 bits está disponível noHKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\sub-chave. Por exemplo, a subchave do registro para .NET Framework 4.5 éHKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Full.

   (Video) Check .Net Framework Version Installed in Your PC | Windows 10

2. Verifica aLiberarValor REG_DWORD para determinar a versão instalada. Para ser compatível com versões anteriores, verifique se há um valor maior ou igual ao valor listado naTabela de versões do .NET Framework.

O exemplo a seguir verifica o valor doLiberarentrada no registro para encontrar as versões do .NET Framework 4.5-4.8.1 que estão instaladas.

const string subkey = @"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\"; using (var ndpKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(subkey)){ if (ndpKey ! = null && ndpKey.GetValue("Release") != null) { Console.WriteLine($".NET Framework Versão: {CheckFor45PlusVersion((int)ndpKey.GetValue("Release"))}"); } else { Console.WriteLine(".NET Framework Versão 4.5 ou posterior não foi detectado."); }}// Verificar a versão usando >= permite compatibilidade futura.string CheckFor45PlusVersion(int releaseKey){ if (releaseKey >= 533320) return "4.8.1 or later"; if (releaseKey >= 528040) return "4.8"; if (releaseKey >= 461808) return "4.7.2"; if (releaseKey >= 461308) return "4.7.1"; if (releaseKey >= 460798) return "4.7"; if (releaseKey >= 394802) return "4.6.2"; if (releaseKey >= 394254) return "4.6.1"; if (releaseKey >= 393295) return "4.6"; if (releaseKey >= 379893) return "4.5.2"; if (releaseKey >= 378675) return "4.5.1"; if (releaseKey >= 378389) return "4.5"; // Este código nunca deve ser executado. Uma chave de liberação não nula deve significar // que a versão 4.5 ou posterior está instalada. return "Nenhuma versão 4.5 ou posterior detectada";}

Private Sub Get45PlusFromRegistry() Const subkey As String = "SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" Using ndpKey As RegistryKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(subkey) If ndpKey IsNot Nothing AndAlso ndpKey.GetValue("Release") IsNot Nothing Then Console.WriteLine($".NET Framework Version: {CheckFor45PlusVersion(ndpKey.GetValue("Release"))}") Else Console.WriteLine(".NET Framework Version 4.5 ou posterior não é detectado.") End If End UsingEnd Sub' Verificar a versão usando >= habilita a compatibilidade futura.Private Function CheckFor45PlusVersion(releaseKey As Integer) As String If releaseKey >= 533320 Then Return "4.8.1 or later" ElseIf releaseKey >= 528040 Then Return "4.8" ElseIf releaseKey >= 461808 Then Return "4.7.2" ElseIf releaseKey >= 461308 Then Return "4.7.1" ElseIf releaseKey >= 460798 Then Return "4.7" ElseIf releaseKey >= 394802 Then Return "4.6.2" ElseIf releaseKey >= 394254 Then Return "4.6.1" ElseIf releaseKey >= 393295 Then Return "4.6" ElseIf releaseKey >= 379893 Then Return "4.5.2" ElseIf releaseKey >= 378675 Then Return "4.5.1 " ElseIf releaseKey >= 378389 Then Return "4.5" End If ' Este código nunca deve ser executado. Uma chave de liberação não nula deve significar 'que 4.5 ou posterior está instalado. Return "Nenhuma versão 4.5 ou posterior detectada" End Function

O exemplo exibe uma saída como a seguinte:

Versão do .NET Framework: 4.6.1

Consultar o registro usando o código PowerShell

O exemplo a seguir usa o PowerShell para verificar o valor doLiberarentrada no registro para encontrar as versões do .NET Framework 4.5-4.8.1 que estão instaladas:

$release = Get-ItemPropertyValue -LiteralPath 'HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full' -Name Releaseswitch ($release) { { $_ -ge 533320 } { $version = '4.8.1 or later '; break } { $_ -ge 528040 } { $version = '4.8'; break } { $_ -ge 461808 } { $version = '4.7.2'; break } { $_ -ge 461308 } { $version = '4.7.1'; break } { $_ -ge 460798 } { $version = '4.7'; break } { $_ -ge 394802 } { $version = '4.6.2'; break } { $_ -ge 394254 } { $version = '4.6.1'; break } { $_ -ge 393295 } { $version = '4.6'; break } { $_ -ge 379893 } { $version = '4.5.2'; break } { $_ -ge 378675 } { $version = '4.5.1'; break } { $_ -ge 378389 } { $version = '4.5'; break } default { $version = $null; break }}if ($version) { Write-Host -Object ".NET Framework Version: $version"} else { Write-Host -Object '.NET Framework Versão 4.5 ou posterior não foi detectado.'}

Este exemplo segue a prática recomendada para verificação de versão:

• Ele verifica se o valor doLiberara entrada éMelhor que ou igual ao valor das chaves de liberação conhecidas.
• Ele verifica na ordem da versão mais recente para a versão mais antiga.

Detectar .NET Framework 1.0 a 4.0

Cada versão do .NET Framework de 1.1 a 4.0 é listada como uma subchave emHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP. A tabela a seguir lista o caminho para cada versão do .NET Framework. Para a maioria das versões, há umInstalarValor REG_DWORD de1para indicar que esta versão está instalada. Nessas subchaves, há também umVersãoValor REG_SZ que contém uma string de versão.

Observe que o caminho do registro para a subchave .NET Framework 1.0 é diferente dos outros.

Use o Editor do Registro (versões de estrutura mais antigas)

1. DeComeçarmenu, escolhaCorrer, digitarregedite, em seguida, selecioneOK.

   Você deve ter credenciais administrativas para executar o regedit.

2. Abra a subchave que corresponde à versão que você deseja verificar. Use a tabela noDetectar .NET Framework 1.0 a 4.0seção.

   A figura a seguir mostra a subchave e suaVersãovalor para .NET Framework 3.5.

   

Consultar o registro usando código (versões de estrutura mais antigas)

Use oMicrosoft.Win32.RegistryKeyaula para acessarHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDPsubchave no registro do Windows.

O exemplo a seguir encontra as versões do .NET Framework 1-4 que estão instaladas:

// Abra a chave de registro para o .NET Framework entry.using (RegistryKey ndpKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32). OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\")){ foreach (var versionKeyName in ndpKey.GetSubKeyNames()) { // Ignorar informações de versão do .NET Framework 4.5. if (versionKeyName == "v4") { continue; } if (versionKeyName.StartsWith("v")) { RegistryKey versionKey = ndpKey.OpenSubKey(versionKeyName); // Obtenha o valor da versão do .NET Framework. var nome = (string)versionKey.GetValue("Versão", ""); // Obtenha o número do service pack (SP). var sp = versionKey.GetValue("SP", "").ToString(); // Obtém o sinalizador de instalação. var install = versionKey.GetValue("Install", "").ToString(); if (string.IsNullOrEmpty(install)) { // Sem informações de instalação; deve estar em uma subchave filha. Console.WriteLine($"{versionKeyName} {nome}"); } else if (install == "1") { // Install = 1 significa que a versão está instalada. if (!string.IsNullOrEmpty(sp)) { Console.WriteLine($"{versionKeyName} {nome} SP{sp}"); } else { Console.WriteLine($"{versionKeyName} {nome}"); } } if (!string.IsNullOrEmpty(nome)) { continue; } // else imprime as informações das subchaves... // Itera através das subchaves da subchave da versão. foreach (var subKeyName em versionKey.GetSubKeyNames()) { RegistryKey subKey = versionKey.OpenSubKey(subKeyName); nome = (string)subKey.GetValue("Versão", ""); if (!string.IsNullOrEmpty(nome)) sp = subKey.GetValue("SP", "").ToString(); install = subKey.GetValue("Instalar", "").ToString(); if (string.IsNullOrEmpty(install)) { // Sem informações de instalação; deve ser mais tarde. Console.WriteLine($" {versionKeyName} {nome}"); } else if (install == "1") { if (!string.IsNullOrEmpty(sp)) { Console.WriteLine($" {subKeyName} {nome} SP{sp}"); } else { Console.WriteLine($" {subKeyName} {nome}"); } } } } }}

' Abre a chave de registro para a entrada do .NET Framework.Using ndpKey As RegistryKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32). OpenSubKey("SOFTWARE\Microsoft\NET Framework Setup\NDP\") For Each versionKeyName In ndpKey.GetSubKeyNames() ' Skip .NET Framework 4.5 and later. If versionKeyName = "v4" Then Continue For If versionKeyName.StartsWith("v") Then Dim versionKey As RegistryKey = ndpKey.OpenSubKey(versionKeyName) ' Obtém o valor da versão do .NET Framework. Dim name = DirectCast(versionKey.GetValue("Version", ""), String) ' Obtém o número do service pack (SP). Dim sp = versionKey.GetValue("SP", "").ToString() Dim install = versionKey.GetValue("Install", "").ToString() If String.IsNullOrEmpty(install) Then ' No install info; deve estar em uma subchave filha. Console.WriteLine($"{versionKeyName} {nome}") ElseIf install = "1" Then If Not String.IsNullOrEmpty(sp) Then Console.WriteLine($"{versionKeyName} {name} SP{sp}") Else Console .WriteLine($"{versionKeyName} {nome}") End If End If Not String.IsNullOrEmpty(name) Then Continue For End If For Each subKeyName In versionKey.GetSubKeyNames() Dim subKey As RegistryKey = versionKey.OpenSubKey(subKeyName) name = DirectCast(subKey.GetValue("Version", ""), String) Se não String.IsNullOrEmpty(name) Then sp = subKey.GetValue("SP", "").ToString() End If install = subKey. GetValue("Install", "").ToString() If String.IsNullOrEmpty(install) Then ' Nenhuma informação de instalação; deve ser mais tarde. Console.WriteLine($" {versionKeyName} {nome}") ElseIf install = "1" Then If Not String.IsNullOrEmpty(sp) Then Console.WriteLine($" {subKeyName} {name} SP{sp}") Else Console .WriteLine($" {subKeyName} {nome}") End If End If Next End If NextEnd Using

O exemplo exibe uma saída semelhante à seguinte:

v2.0.50727 2.0.50727.4927 SP2v3.0 3.0.30729.4926 SP2v3.5 3.5.30729.4926 SP1v4.0 Cliente 4.0.0.0

Consultar o registro usando o PowerShell (versões de estrutura mais antigas)

O exemplo a seguir usa o PowerShell para verificar o valor doLiberarentrada no registro para encontrar as versões do .NET Framework 1-4 que estão instaladas:

Get-ChildItem -Path 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP' |Where-Object { ($_.PSChildName -ne "v4") -e ($_.PSChildName -like 'v*') } |ForEach-Object { $name = $_.Version $sp = $_.SP $install = $_.Install if (-not $install) { Write-Host -Object "$($_.PSChildName) $($ nome)" } elseif ($install -eq '1') { if (-not $sp) { Write-Host -Object "$($_.PSChildName) $($name)" } else { Write-Host -Object "$($_.PSChildName) $($name) SP$($sp)" }} if (-not $name) { $parentName = $_.PSChildName Get-ChildItem -LiteralPath $_.PSPath | Where-Object { if ($_.Property -contains 'Version') { $name = Get-ItemPropertyValue -Path $_.PSPath -Name Version } if ($name -and ($_.Property -contains 'SP') ) { $sp = Get-ItemPropertyValue -Path $_.PSPath -Name SP } if ($_.Property -contains 'Install') { $install = Get-ItemPropertyValue -Path $_.PSPath -Name Install } if (- not $install) { Write-Host -Object " $($parentName) $($name)" } elseif ($install -eq '1') { if (-not $sp) { Write-Host -Object " $( $_.PSChildName) $($name)" } else { Write-Host -Object " $($_.PSChildName) $($name) SP$($sp)" } } } }}

Encontrar versões CLR

O .NET Framework CLR instalado com o .NET Framework tem versão separada. Há duas maneiras de detectar a versão do .NET Framework CLR:

• A ferramenta Clrver.exe

  (Video) How to Check .net Version | Check .Net Framework Version Installed | Check .NET Framework Version

  Use oFerramenta de versão CLR (Clrver.exe)para determinar quais versões do CLR estão instaladas em um computador. AbrirPrompt de comando do desenvolvedor do Visual Studio ou PowerShell do desenvolvedor do Visual Studioe entrarclrver.

  Exemplo de saída:

  Versões instaladas na máquina:v2.0.50727v4.0.30319

• OAmbienteaula

  Importante

  Para .NET Framework 4.5 e versões posteriores, não use oAmbiente.Versãopropriedade para detectar a versão do CLR. Em vez disso, consulte o registro conforme descrito emDetectar .NET Framework 4.5 e versões posteriores.

  1. Consultar oAmbiente.Versãopropriedade para recuperar umVersãoobjeto.

     O devolvidoSystem.VersionO objeto identifica a versão do tempo de execução que está executando o código no momento. Ele não retorna versões de assembly ou outras versões do tempo de execução que podem ter sido instaladas no computador.

     Para as versões 4, 4.5, 4.5.1 e 4.5.2 do .NET Framework, a representação de string do retornoVersãoobjeto tem o formato 4.0.30319.xxxxx, ondexxxxxé menor que 42000. Para .NET Framework 4.6 e versões posteriores, tem o formato 4.0.30319.42000.

  2. Depois que você tiver oVersãoobjeto, consulte-o da seguinte forma:

     • Para o identificador de versão principal (por exemplo,4para a versão 4.0), use oVersão.Principalpropriedade.

     • Para o identificador de versão secundária (por exemplo,0para a versão 4.0), use oVersão.Menorpropriedade.

     • Para toda a string de versão (por exemplo,4.0.30319.18010), use oVersão.ToStringmétodo. Esse método retorna um único valor que reflete a versão do tempo de execução que está executando o código. Ele não retorna versões de assembly ou outras versões de tempo de execução que possam estar instaladas no computador.

  O exemplo a seguir usa oAmbiente.Versãopropriedade para recuperar informações da versão CLR:

  Console.WriteLine($"Versão: {Environment.Version}");

  Console.WriteLine($"Versão: {Ambiente.Versão}")

  O exemplo exibe uma saída semelhante à seguinte:

  Versão: 4.0.30319.18010

Veja também

• Como: determinar quais atualizações do .NET Framework estão instaladas
• Solução de problemas: determine quais versões e service packs do .NET Framework estão instalados
• Instale o .NET Framework para desenvolvedores
• Versões e dependências do .NET Framework