Crie aplicações com Microsoft.NETFramework.ReferenceAssemblies

Quando se dirige a uma versão específica do .NET Framework, por padrão, a sua aplicação é criada usando os assemblies de referência incluídos no kit de desenvolvimento dessa versão. Em cenários em que o pacote de desenvolvedor correspondente não puder ser instalado no computador, poderá compilar com base em assemblagens de referência distribuídas por meio de um pacote NuGet.

Atualizar arquivos de projeto

Cada projeto que precisa ser compilado utilizando os assemblies de referência do pacote NuGet deve incluir uma referência a Microsoft.NETFramework.ReferenceAssemblies.

Projetos que usam um arquivo packages.config devem incluir o seguinte em packages.config.

<packages>
  <package id="Microsoft.NETFramework.ReferenceAssemblies" version="1.0.3" developmentDependency="true" />
</packages>

Projetos que usam a <PackageReference> propriedade MSBuild devem incluir a seguinte propriedade no arquivo de projeto.

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
</ItemGroup>

Projetos no estilo SDK incluem essa referência por padrão. Para projetos típicos do .NET Framework que foram criados com o Visual Studio, você pode adicionar a referência usando a interface do usuário do Gerenciador de Pacotes NuGet no Visual Studio. O pacote contém assemblies de referência para muitas versões do .NET Framework. A versão realmente usada é determinada pela propriedade TargetFrameworkVersion ou TargetFramework, conforme já definido no ficheiro de projeto.

Restaurar o projeto

Os projetos que contêm uma referência de pacote devem ser restaurados antes de poderem ser criados.

Depois de adicionar o pacote NuGet Microsoft.NETFramework.ReferenceAssemblies ao seu projeto, você deve executar explicitamente a ação de restauração de uma das seguintes maneiras:

• Se o seu projeto não for no estilo SDK e usar o arquivo packages.config para fazer referência a pacotes NuGet:

  1. Instale a ferramenta NuGet CLI e verifique se nuget.exe está na PATH variável de ambiente.
  2. Abra um prompt de comando.
  3. Navegue até o diretório que contém o arquivo de projeto.
  4. Execute nuget.exe restore.

• Se o seu projeto não for de estilo SDK e utilizar as configurações <PackageReference> no arquivo de projeto para fazer referência a pacotes NuGet:

  1. Abra o prompt de comando do desenvolvedor para VS 2022. O nome deste aplicativo pode ser diferente com base em qual versão do Visual Studio você instalou.
  2. Navegue até o diretório que contém o arquivo de projeto.
  3. Execute msbuild /t:restore.

• Se o seu projeto for um projeto no estilo SDK, você não precisará fazer nada. A ação de restauração do NuGet é executada automaticamente quando o projeto é criado.