Elemento <startup>

Artículo
08/10/2011

Especifica información de inicio de Common Language Runtime.

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

Atributos y elementos

En las secciones siguientes 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 runtime .NET Framework versión 2.0 o se debe usar la directiva de activación .NET Framework versión 4.

useLegacyV2RuntimeActivationPolicy

Atributo opcional.

Especifica si se debe habilitar la directiva de activación del runtime .NET Framework versión 2.0 o se debe usar la directiva de activación .NET Framework versión 4.

useLegacyV2RuntimeActivationPolicy (Atributo)

Valor	Descripción
true	Habilite la directiva de activación del runtime de .NET Framework versión 2.0 para el runtime elegido, que es enlazar las técnicas de activación del runtime heredado (como la función CorBindToRuntimeEx) al runtime elegido desde el archivo de configuración en lugar de completarlas en la versión 2.0 de CLR. Por lo tanto, si se elije CLR versión 4 o posterior del archivo de configuración, los ensamblados de modo mixto creados con versiones anteriores de la.NET Framework se cargarán con la versión de CLR elegida. Este valor impide que la versión 1.1 o 2.0 de CLR se cargue en el mismo proceso, deshabilitando la característica en paralelo en curso.
false	Use la directiva de activación predeterminada de .NET Framework 4 y posterior, que consiste en permitir que las técnicas de activación del runtime heredado 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 o posterior, a menos que se compilaran con .NET Framework 4 o posterior. Este valor es el predeterminado.

true

Habilite la directiva de activación del runtime de .NET Framework versión 2.0 para el runtime elegido, que es enlazar las técnicas de activación del runtime heredado (como la función CorBindToRuntimeEx) al runtime elegido desde el archivo de configuración en lugar de completarlas en la versión 2.0 de CLR. Por lo tanto, si se elije CLR versión 4 o posterior del archivo de configuración, los ensamblados de modo mixto creados con versiones anteriores de la.NET Framework se cargarán con la versión de CLR elegida. Este valor impide que la versión 1.1 o 2.0 de CLR se cargue en el mismo proceso, deshabilitando la característica en paralelo en curso.

false

Use la directiva de activación predeterminada de .NET Framework 4 y posterior, que consiste en permitir que las técnicas de activación del runtime heredado 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 o posterior, a menos que se compilaran con .NET Framework 4 o posterior. Este valor es el predeterminado.

Elementos secundarios

Elemento	Descripción
<requiredRuntime>	Especifica que la aplicación sólo es compatible con la versión 1.0 de Common Language Runtime. Las aplicaciones compiladas con el motor en tiempo de ejecución versión 1.1 o posterior 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 en tiempo de ejecución deberían usar el elemento <supportedRuntime>. Las aplicaciones compiladas para ser compatibles únicamente con la versión 1.0 del motor en tiempo de ejecución deben usar el elemento <requiredRuntime>.

El código de inicio de una aplicación hospedada en Microsoft Internet Explorer omite el elemento <startup> y sus elementos secundarios.

El atributo UseLegacyV2RuntimeActivationPolicy

Este atributo resulta útil si su aplicación utiliza rutas de activación heredadas, como la función CorBindToRuntimeEx, y desea que las rutas activen la versión 4 de CLR en lugar de una versión anterior, o si su aplicación está compilada con .NET Framework 4 pero tiene una dependencia en un ensamblado de modo mixto creado con una versión anterior de .NET Framework. En esos escenarios, establezca el atributo en true.

Nota
Establecer el atributo en true impide que la versión 1.1 o 2.0 de CLR se cargue en el mismo proceso, deshabilitando la característica en paralelo en curso (vea Ejecución simultánea para interoperabilidad COM).

Ejemplo

En el siguiente ejemplo se muestra cómo especificar la versión del motor de ejecució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>

Vea también