Compartilhar via


<startup> elemento

Especifica informações de inicialização do Common Language Runtime.

<inicialização de configuração><>

Sintaxe

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Attribute Description
useLegacyV2RuntimeActivationPolicy Atributo opcional.

Especifica se a política de ativação do runtime do .NET Framework 2.0 deve ser habilitada ou usar a política de ativação do .NET Framework 4.

atributo useLegacyV2RuntimeActivationPolicy

Value Description
true Habilite a política de ativação do runtime do .NET Framework 2.0 para o runtime escolhido, que é associar técnicas de ativação de runtime herdada (como a função CorBindToRuntimeEx) ao runtime escolhido do arquivo de configuração em vez de encadeá-las no CLR versão 2.0. Portanto, se CLR versão 4 ou posterior for escolhida do arquivo de configuração, assemblies de modo misto criados com versões anteriores do .NET Framework serão carregados com a versão CLR escolhida. Definir esse valor impede que o CLR versão 1.1 ou CLR versão 2.0 seja carregado no mesmo processo, desabilitando efetivamente o recurso lado a lado no processo.
false Use a política de ativação padrão para o .NET Framework 4 e posterior, que é permitir técnicas de ativação de runtime herdada para carregar CLR versão 1.1 ou 2.0 no processo. Definir esse valor impede que assemblies de modo misto sejam carregados no .NET Framework 4 ou posterior, a menos que tenham sido criados com o .NET Framework 4 ou posterior. Esse valor é o padrão.

Elementos filho

Elemento Description
<requiredRuntime> Especifica que o aplicativo dá suporte apenas à versão 1.0 do common language runtime. Os aplicativos criados com o runtime versão 1.1 ou posterior devem usar o <supportedRuntime> elemento.
<supportedRuntime> Especifica quais versões do common language runtime o aplicativo dá suporte.

Elementos pai

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.

Observações

O <supportedRuntime> elemento deve ser usado por todos os aplicativos criados usando a versão 1.1 ou posterior do runtime. Os aplicativos criados para dar suporte somente à versão 1.0 do runtime devem usar o <requiredRuntime> elemento.

O atributo useLegacyV2RuntimeActivationPolicy

Esse atributo será útil se o aplicativo usar caminhos de ativação herdados, como a função CorBindToRuntimeEx, e você quiser que esses caminhos ativem a versão 4 do CLR em vez de uma versão anterior ou se o aplicativo for criado com o .NET Framework 4, mas tiver uma dependência em um assembly de modo misto criado com uma versão anterior do .NET Framework. Nesses cenários, defina o atributo como true.

Observação

Definir o atributo para true impedir que o CLR versão 1.1 ou CLR versão 2.0 seja carregado no mesmo processo, desabilitando efetivamente o recurso lado a lado no processo (consulte Execução lado a lado para interoperabilidade COM).

Example

O exemplo a seguir mostra como especificar a versão de runtime em um arquivo de configuração.

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

Consulte também