Elemento <supportedRuntime>

Artículo
05/10/2023

Especifica qué versión de Common Language Runtime y, opcionalmente, la versión de .NET Framework admite la aplicación.

<configuración>
<startup>
<supportedRuntime>

Sintaxis

<supportedRuntime version="runtime version" sku="SKU ID"/>

Atributos

Atributo Descripción

version Atributo opcional.

Un valor de cadena que especifica la versión de Common Language Runtime (CLR) que es compatible con esta aplicación. Para conocer los valores válidos del atributo version, consulte la sección de valroes «runtime version». Nota: A través de .NET Framework 3.5, el valor "runtime version" adopta la forma major.minor.build. A partir de .NET Framework, solo se requieren los números de versión principal y secundaria "(es decir, "v4.4" en lugar de "v4.0.0.30319"). Se recomienda la cadena más corta.

sku Atributo opcional.

Valor de cadena que especifica la referencia de almacén (SKU), que a su vez especifica qué versión de .NET Framework es compatible con esta aplicación.

A partir de .NET Framework 4.0, se recomienda el uso del atributo sku. Cuando está presente, indica la versión de .NET Framework que la aplicación tiene como destino.

Para conocer los valores válidos del atributo sku, consulte la sección «SKU values».

Atributo	Descripción
version	Atributo opcional. Un valor de cadena que especifica la versión de Common Language Runtime (CLR) que es compatible con esta aplicación. Para conocer los valores válidos del atributo `version`, consulte la sección de valroes «runtime version». Nota: A través de .NET Framework 3.5, el valor "runtime version" adopta la forma major.minor.build. A partir de .NET Framework, solo se requieren los números de versión principal y secundaria "(es decir, "v4.4" en lugar de "v4.0.0.30319"). Se recomienda la cadena más corta.
sku	Atributo opcional. Valor de cadena que especifica la referencia de almacén (SKU), que a su vez especifica qué versión de .NET Framework es compatible con esta aplicación. A partir de .NET Framework 4.0, se recomienda el uso del atributo `sku`. Cuando está presente, indica la versión de .NET Framework que la aplicación tiene como destino. Para conocer los valores válidos del atributo `sku`, consulte la sección «SKU values».

Observaciones

Si el elemento <supportedRuntime> no está presente en el archivo de configuración de la aplicación, se usará la versión del motor en tiempo de ejecución utilizado para compilar la aplicación.

Todas las aplicaciones compiladas con la versión 1.1 o posterior del motor del entorno de ejecución deberían usar el elemento <supportedRuntime>. Las aplicaciones compiladas para ser compatibles únicamente con la versión 1.0 del motor del entorno de ejecución deben usar el elemento <supportedRuntime>.

Nota:

Si utiliza la función CorBindToRuntimeByCfg para especificar el archivo de configuración, debe utilizar el elemento <requiredRuntime> para todas las versiones del runtime. Se omite el elemento <supportedRuntime> al usar CorBindToRuntimeByCfg.

En el caso de aplicaciones que admiten versiones del runtime de .NET Framework 1.1 a través de la versión 3.5, cuando se admiten varias versiones del runtime, el primer elemento debería especificar la versión preferida y el último elemento la que se considera como última posibilidad. Para las aplicaciones compatibles con .NET Framework 4.0 o versiones posteriores, el atributo version indica la versión CLR, que es común para el .NET Framework 4 y versiones posteriores, y el atributo sku indica la única versión de .NET Framework que la aplicación tiene como destino.

Si el <elemento supportedRuntime> con el atributo sku está presente en el archivo de configuración y la versión instalada de .NET Framework es inferior a la versión admitida especificada, la aplicación no se puede ejecutar y, en su lugar, muestra un mensaje que pide que instale la versión admitida. De lo contrario, la aplicación intenta ejecutarse en cualquier versión instalada, pero puede comportarse inesperadamente si no es totalmente compatible con esa versión. (Para conocer las diferencias de compatibilidad entre las versiones de .NET Framework, consulte Compatibilidad de aplicaciones en .NET Framework). Por lo tanto, se recomienda incluir este elemento en el archivo de configuración de la aplicación para facilitar el diagnóstico de errores. (El archivo de configuración generado automáticamente por Visual Studio al crear un proyecto ya lo contiene).

Nota:

Si la aplicación usa rutas de activación heredadas, como la función CorBindToRuntimeEx, y desea que dichas rutas activen la versión 4 de CLR en lugar de una versión anterior, o si la aplicación está compilada con .NET Framework 4 pero tiene una dependencia en un ensamblado de modo mixto compilado con una versión anterior de .NET Framework, no es suficiente especificar .NET Framework 4 en la lista de aplicaciones compatibles. Además, en el elemento <startup> del archivo de configuración, debe establecer el atributo useLegacyV2RuntimeActivationPolicy en true. Sin embargo, establecer este atributo en true significa que todos los componentes compilados con versiones anteriores de .NET Framework se ejecutan utilizando .NET Framework 4 en lugar de los runtimes con los que se compilaron.

Se recomienda probar las aplicaciones con todas las versiones de .NET Framework en las que puedan ejecutarse.

Valores de "runtime version"

El atributo runtime especifica la versión de Common Language Runtime (CLR) necesaria para una aplicación determinada. Todas las versiones de .NET Framework v4.x especifican CLR v4.0. En la tabla siguiente se enumeran los valores válidos para el valor runtime version del atributo version.

Versión de .NET Framework	Atributo `version`
1,0	"v1.0.3705"
1.1	"v1.1.4322"
2,0	"v2.0.50727"
3.0	"v2.0.50727"
3,5	"v2.0.50727"
4.0-4.8.1	"v4.0"

Valores de "SKU ID"

El atributo sku usa un moniker de la plataforma de destino (TFM) para indicar la versión de .NET Framework que la aplicación tiene como destino y requiere ejecutarse. En la tabla siguiente se enumeran los valores válidos admitidos por el atributo sku, a partir de .NET Framework 4.

Versión de .NET Framework	Atributo `sku`
4,0	".NETFramework,Version=v4.0"
4.0, Client Profile	".NETFramework,Version=v4.0,Profile=Client"
4.0, actualización 1 de la plataforma	".NETFramework,Version=v4.0.1"
4.0, Client Profile, actualización 1	".NETFramework,Version=v4.0.1,Profile=Client"
4.0, actualización 2 de la plataforma	".NETFramework,Version=v4.0.2"
4.0, Client Profile, actualización 2	".NETFramework,Version=v4.0.2,Profile=Client"
4.0, actualización 3 de la plataforma	".NETFramework,Version=v4.0.3"
4.0, Client Profile, actualización 3	".NETFramework,Version=v4.0.3,Profile=Client"
4,5	".NETFramework,Version=v4.5"
4.5.1	".NETFramework,Version=v4.5.1"
4.5.2	".NETFramework,Version=v4.5.2"
4,6	".NETFramework,Version=v4.6"
4.6.1	".NETFramework,Version=v4.6.1"
4.6.2	".NETFramework,Version=v4.6.2"
4,7	".NETFramework,Version=v4.7"
4.7.1	".NETFramework,Version=v4.7.1"
4.7.2	".NETFramework,Version=v4.7.2"
4.8	".NETFramework,Version=v4.8"
4.8.1	".NETFramework,Version=v4.8.1"

Ejemplo

En el ejemplo siguiente se muestra cómo especificar la versión del runtime compatible en un archivo de configuración. El archivo de configuración indica que la aplicación tiene como destino .NET Framework 4.7.

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

Archivo de configuración

Este elemento se puede utilizar en el archivo de configuración de la aplicación.