Desarrollar aplicaciones con Microsoft.NETFramework.ReferenceAssemblies

Cuando se dirige a una versión determinada de .NET Framework, de forma predeterminada, la aplicación se compila mediante los ensamblados de referencia que se incluyen con el paquete de desarrollo de esa versión. En escenarios en los que no se puede instalar el paquete de desarrollador coincidente en el equipo, puede compilar en ensamblados de referencia distribuidos mediante un paquete NuGet en su lugar.

Actualizar archivos de proyecto

Cada proyecto que se debe compilar con los ensamblados de referencia del paquete NuGet debe incluir una referencia a Microsoft.NETFramework.ReferenceAssemblies.

Los proyectos que usan un archivo depackages.config deben incluir lo siguiente en packages.config.

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

Los proyectos que usan la <PackageReference> propiedad MSBuild deben incluir la siguiente propiedad en el archivo del proyecto.

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

Los proyectos de estilo SDK incluyen esta referencia de forma predeterminada. Para los proyectos típicos de .NET Framework creados con Visual Studio, puede agregar la referencia mediante la interfaz de usuario del Administrador de paquetes NuGet en Visual Studio. El paquete contiene ensamblados de referencia para muchas versiones de .NET Framework. La versión que se usa realmente viene determinada por la TargetFrameworkVersion propiedad o TargetFramework , como ya se ha definido en el archivo del proyecto.

Restauración del proyecto

Los proyectos que contienen una referencia de paquete deben restaurarse para poder compilarse.

Después de agregar el paquete NuGet Microsoft.NETFramework.ReferenceAssemblies al proyecto, debe ejecutar explícitamente la acción de restauración de una de las maneras siguientes:

• Si el proyecto es un proyecto que no es de estilo SDK y usa el archivo packages.config para hacer referencia a paquetes NuGet:

  1. Instale la herramienta de la CLI de NuGet y asegúrese de quenuget.exe está en la PATH variable de entorno.
  2. Abra una ventana de comandos.
  3. Vaya al directorio que contiene el archivo del proyecto.
  4. Ejecute nuget.exe restore.

• Si el proyecto es un proyecto que no sigue el estilo SDK y usa <PackageReference> configuración en el archivo de proyecto para referenciar paquetes NuGet:

  1. Abra el Símbolo del sistema para desarrolladores de VS 2022. El nombre de esta aplicación puede ser diferente en función de la versión de Visual Studio que haya instalado.
  2. Vaya al directorio que contiene el archivo del proyecto.
  3. Ejecute msbuild /t:restore.

• Si el proyecto es un proyecto de estilo SDK, no es necesario hacer nada. La acción de restauración de NuGet se ejecuta automáticamente cuando se compila el proyecto.