BuildManager.TargetFramework Propiedad

Definición

Espacio de nombres:

System.Web.Compilation

Ensamblado:

System.Web.dll

Obtiene la versión de destino de .NET Framework del sitio web actual.

public:
 static property System::Runtime::Versioning::FrameworkName ^ TargetFramework { System::Runtime::Versioning::FrameworkName ^ get(); };

public static System.Runtime.Versioning.FrameworkName TargetFramework { get; }

static member TargetFramework : System.Runtime.Versioning.FrameworkName

Public Shared ReadOnly Property TargetFramework As FrameworkName

Valor de propiedad

FrameworkName

Versión de destino de .NET Framework del sitio web actual.

Comentarios

Esta propiedad admite la característica de múltiples versiones de ASP.NET, que permite usar la versión más reciente de Visual Studio para desarrollar aplicaciones que se ejecutarán con versiones anteriores de .NET Framework. Un proveedor de compilación puede usar esta propiedad para asegurarse de que el proveedor genera código adecuado para la versión de destino de .NET Framework. Por ejemplo, puede que desee generar código diferente en función de si un sitio web tiene como destino .NET Framework 3.5 o .NET Framework 4. Para obtener más información sobre la compatibilidad con múltiples versiones, vea .NET Framework Multi-Targeting for ASP.NET Web Projects.

Si el sitio web no tiene un archivo Web.config, ASP.NET supone que la versión de la plataforma de destino es la versión asociada al grupo de aplicaciones de IIS en el que se ejecuta el sitio. Para un sitio web del sistema de archivos que se ejecuta en Visual Studio, la versión predeterminada del marco es la versión actual de .NET Framework.

Si el sitio web tiene un archivo Web.config, ASP.NET determina la plataforma de destino examinando el archivo Web.config.

Sitios web que tienen como destino .NET Framework 2.0

Las aplicaciones web destinadas a .NET Framework 2.0 se compilan como si el destino fuera .NET Framework 3.0. El proceso de compilación no diferencia entre .NET Framework 2.0 y .NET Framework 3.0 porque el archivo Web.config no indica la versión del compilador ni la plataforma de destino cuando se destina una de esas versiones. (Para .NET Framework 3.5, el archivo Web.config especifica la versión del compilador y para .NET Framework 4, el archivo Web.config especifica la plataforma de destino). Por lo tanto, para las aplicaciones web que tienen como destino .NET Framework 2.0, esta propiedad devuelve un moniker de la plataforma de destino que indica .NET Framework 3.0.

Esto normalmente no causará ningún problema. Visual Studio impide crear referencias a características de .NET Framework 3.0 en un proyecto destinado a .NET Framework 2.0. Por ejemplo, Visual Studio no proporciona plantillas de elementos para servicios WCF en un proyecto destinado a .NET Framework 2.0, porque WCF se introdujo con .NET Framework 3.0 y no es compatible con .NET Framework 2.0.

Si tiene previsto implementar un sitio web en un entorno en tiempo de ejecución de .NET Framework 2.0 y usa una herramienta distinta de Visual Studio para hacer referencia a características que solo son compatibles con .NET Framework 3.0, el proyecto podría compilarse sin generar errores ni advertencias. Sin embargo, la aplicación podría generar errores cuando el sitio web se ejecuta en .NET Framework 2.0.