Elemento <startup>

Article
03/30/2023

Especifica información de inicio de Common Language Runtime.

Sintaxis

<startup useLegacyV2RuntimeActivationPolicy="true|false" >
</startup>

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
`useLegacyV2RuntimeActivationPolicy`	Atributo opcional. Especifica si se debe habilitar la directiva de activación del entorno de ejecución de .NET Framework 2.0 o usar la directiva de activación de .NET Framework 4.

atributo useLegacyV2RuntimeActivationPolicy

Valor Descripción

true Habilite la directiva de activación del entorno de ejecución de .NET Framework 2.0 para el entorno de ejecución elegido, el cual enlazará las técnicas de activación de entorno de ejecución heredadas (como la función CorBindToRuntimeEx) con el entorno de ejecución elegido en el archivo de configuración en lugar de limitarlas a la versión 2.0 de CLR. Por tanto, si se elige la versión 4, u otra posterior, de CLR en el archivo de configuración, los ensamblados de modo mixto creados con versiones anteriores de .NET Framework se cargarán con la versión de CLR elegida. Mediante la configuración de este valor se impide que CLR versión 1.1 o CLR versión 2.0 se cargue en el mismo proceso. De este modo, se deshabilita la característica de procesamiento paralelo de forma efectiva.

false Use la directiva de activación predeterminada para .NET Framework 4 y versiones posteriores, que permite que las técnicas de activación del entorno de ejecución heredadas carguen la versión 1.1 o 2.0 de CLR en el proceso. Establecer este valor impide que los ensamblados de modo mixto se carguen en .NET Framework 4 u otra versión posterior, a menos que se hayan compilado con .NET Framework 4 o posterior. Este es el valor predeterminado.

Valor	Descripción
`true`	Habilite la directiva de activación del entorno de ejecución de .NET Framework 2.0 para el entorno de ejecución elegido, el cual enlazará las técnicas de activación de entorno de ejecución heredadas (como la función CorBindToRuntimeEx) con el entorno de ejecución elegido en el archivo de configuración en lugar de limitarlas a la versión 2.0 de CLR. Por tanto, si se elige la versión 4, u otra posterior, de CLR en el archivo de configuración, los ensamblados de modo mixto creados con versiones anteriores de .NET Framework se cargarán con la versión de CLR elegida. Mediante la configuración de este valor se impide que CLR versión 1.1 o CLR versión 2.0 se cargue en el mismo proceso. De este modo, se deshabilita la característica de procesamiento paralelo de forma efectiva.
`false`	Use la directiva de activación predeterminada para .NET Framework 4 y versiones posteriores, que permite que las técnicas de activación del entorno de ejecución heredadas carguen la versión 1.1 o 2.0 de CLR en el proceso. Establecer este valor impide que los ensamblados de modo mixto se carguen en .NET Framework 4 u otra versión posterior, a menos que se hayan compilado con .NET Framework 4 o posterior. Este es el valor predeterminado.

Elementos secundarios

Elemento	Descripción
<requiredRuntime>	Especifica que la aplicación solo admite la versión 1.0 de Common Language Runtime. Las aplicaciones compiladas con la versión 1.1 u otra posterior del entorno de ejecución deberían usar el elemento <supportedRuntime>.
<supportedRuntime>	Especifica qué versiones de Common Language Runtime admite la aplicación.

Elementos primarios

Elemento	Descripción
`configuration`	Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.

Comentarios

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>.

Atributo useLegacyV2RuntimeActivationPolicy

Este atributo es útil si la aplicación usa rutas de activación heredadas, como la función CorBindToRuntimeEx, y desea que esas 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. En esos escenarios, establezca el atributo en true.

Nota

Al establecer el atributo en true, se impide que CLR versión 1.1 o CLR versión 2.0 se cargue en el mismo proceso. De este modo, se deshabilita la característica de procesamiento paralelo de forma efectiva (consulte Ejecución simultánea para interoperabilidad COM).

Ejemplo

En el ejemplo siguiente se muestra cómo especificar la versión del entorno de configuración en un archivo de configuración.

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

Comparteix a través de