Versión de .NET Framework de destino y plataforma de destino de MSBuild

Un proyecto se puede compilar para ejecutarse en una plataforma de destino, que es una versión determinada de .NET Framework y una plataforma de destino, que es una arquitectura de software determinada. Por ejemplo, puede tener como destino una aplicación para que se ejecute en .NET Framework 2.0 en una plataforma de 32 bits compatible con la familia de procesadores 80x86 ("x86"). La combinación del marco de destino y la plataforma de destino se conoce como el contexto de destino .

Marco de destino y perfil

Una plataforma de destino es la versión concreta de .NET Framework en la que se compila el proyecto para ejecutarse. Se requiere la especificación de una plataforma de destino porque habilita las características del compilador y las referencias de ensamblado que son exclusivas de esa versión del marco de trabajo.

Actualmente, las siguientes versiones de .NET Framework están disponibles para su uso, aunque algunas ya no son compatibles con Microsoft y algunas tienen fechas futuras planeadas más allá de las cuales ya no se admitirán. Para obtener la información de soporte técnico más reciente, consulte .NET Framework:

• .NET Framework 2.0 (incluido en Visual Studio 2005)

• .NET Framework 3.0 (incluido en Windows Vista)

• .NET Framework 3.5 (incluido en Visual Studio 2008)

• .NET Framework 4.0

• .NET Framework 4.5.2

• .NET Framework 4.6 (incluido en Visual Studio 2015)

• .NET Framework 4.6.1

• .NET Framework 4.6.2

• .NET Framework 4.7

• .NET Framework 4.7.1

• .NET Framework 4.7.2

• .NET Framework 4.8

Las versiones de .NET Framework difieren entre sí en la lista de ensamblados que cada uno pone a disposición para hacer referencia. Por ejemplo, no puede compilar aplicaciones de Windows Presentation Foundation (WPF) a menos que el proyecto tenga como destino .NET Framework versión 3.0 o posterior.

La plataforma de destino se especifica en la TargetFrameworkVersion propiedad del archivo del proyecto. Puede cambiar la plataforma de destino de un proyecto mediante las páginas de propiedades del proyecto en el entorno de desarrollo integrado (IDE) de Visual Studio. Para obtener más información, vea Cómo: Establecer como destino una versión de .NET Framework. Los valores disponibles para TargetFrameworkVersion son v2.0, v3.0, , v4.0v3.5, v4.5.2v4.6, v4.6.1, v4.6.2, v4.7, , , v4.7.1, y v4.7.2v4.8.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>

Un perfil de destino es un subconjunto de una plataforma de destino. Por ejemplo, el perfil de cliente de .NET Framework 4 no incluye referencias a los ensamblados de MSBuild.

El perfil de destino se especifica en la TargetFrameworkProfile propiedad de un archivo de proyecto. Puede cambiar el perfil de destino mediante el control target-framework en las páginas de propiedades del proyecto en el IDE.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
<TargetFrameworkProfile>Client</TargetFrameworkProfile>

Plataforma de destino

Una plataforma es una combinación de hardware y software que define un entorno en tiempo de ejecución determinado. Por ejemplo

• x86 designa un sistema operativo Windows de 32 bits que se ejecuta en un procesador Intel 80x86 o su equivalente.
• x64 designa un sistema operativo Windows de 64 bits que se ejecuta en un procesador Intel x64 o su equivalente.
• anycpu designa la salida configurada para poder ejecutarse en cualquier plataforma. La aplicación se ejecuta como un proceso de 64 bits siempre que sea posible y recurre a 32 bits solo cuando el modo está disponible.
• anycpu32bitpreferred designa la salida que se ejecuta en cualquier plataforma. La aplicación se ejecuta en modo de 32 bits en sistemas que admiten aplicaciones de 64 y 32 bits.
• Xbox designa la plataforma Microsoft Xbox 360.
• ARM compila el ensamblado para que se ejecute en un equipo que tenga un procesador avanzado de RISC Machine (ARM).
• ARM64 compila el ensamblado para que se ejecute en clR de 64 bits en un equipo que tenga un procesador avanzado de MÁQUINA RISC (ARM) que admita el conjunto de instrucciones A64.

Una plataforma de destino es la plataforma concreta en la que se compila el proyecto para ejecutarse. La plataforma de destino se especifica en la PlatformTarget propiedad build de un archivo de proyecto. Puede cambiar la plataforma de destino mediante las páginas de propiedades del proyecto o configuration Manager en el IDE.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
</PropertyGroup>

El PlatformTarget valor se pasa al compilador para determinar qué salida se va a generar. En el caso de los proyectos de C#, se asigna a la opción -platformdel compilador de C#. Las opciones de la plataforma se explican con más detalle en Opciones del compilador: PlatformTarget.

Una configuración de destino es un subconjunto de una plataforma de destino. Por ejemplo, la x86Debug configuración no incluye la mayoría de las optimizaciones de código. La configuración de destino se especifica en la Configuration propiedad build de un archivo de proyecto. Puede cambiar la configuración de destino mediante las páginas de propiedades del proyecto o Configuration Manager.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
   <Configuration>Debug</Configuration>
</PropertyGroup>

Contenido relacionado

• Compatibilidad con múltiples versiones (multi-targeting)