Partilhar via


elemento <startup>

Especifica a informação de arranque em tempo de execução da linguagem comum.

<Arranque 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 deve ativar a política de ativação em tempo de execução do .NET Framework 2.0 ou se deve usar a política de ativação do .NET Framework 4.

atributo useLegacyV2RuntimeActivationPolicy

Valor Description
true Ative a política de ativação em tempo de execução do .NET Framework 2.0 para o runtime escolhido, que consiste em vincular técnicas legadas de ativação em tempo de execução (como a função CorBindToRuntimeEx) ao runtime escolhido do ficheiro de configuração em vez de os limitar à versão 2.0 do CLR. Assim, se a versão 4 do CLR ou posterior for escolhida do ficheiro de configuração, os assemblies de modo misto criados com versões anteriores do .NET Framework são carregados com a versão do CLR escolhida. Definir este valor impede que o CLR versão 1.1 ou CLR 2.0 carregue no mesmo processo, desativando efetivamente a funcionalidade lado a lado em processo.
false Use a política de ativação padrão para o .NET Framework 4 e versões posteriores, que permite que técnicas legadas de ativação em tempo de execução carreguem a versão 1.1 ou 2.0 do CLR no processo. Definir este valor impede que assemblies de modo misto carreguem no .NET Framework 4 ou posterior, a menos que tenham sido construídos com o .NET Framework 4 ou posterior. Esse valor é o padrão.

Elementos filho

Elemento Description
<requiredRuntime> Especifica que a aplicação suporta apenas a versão 1.0 do runtime da linguagem comum. Aplicações construídas com a versão de execução 1.1 ou posterior devem usar o <supportedRuntime> elemento.
<suportadoRuntime> Especifica quais as versões do runtime da linguagem comum que a aplicação suporta.

Elementos pai

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

Observações

O <supportedRuntime> elemento deve ser utilizado por todas as aplicações construídas com a versão 1.1 ou posterior do runtime. Aplicações construídas para suportar apenas a versão 1.0 do runtime devem usar o <requiredRuntime> elemento.

O atributo useLegacyV2RuntimeActivationPolicy

Este atributo é útil se a sua aplicação usar caminhos de ativação legados, como a função CorBindToRuntimeEx, e quiser que esses caminhos ativem a versão 4 do CLR em vez de uma versão anterior, ou se a sua aplicação for construída com o .NET Framework 4 mas depender de um assembly de modo misto construído com uma versão anterior do .NET Framework. Nesses cenários, defina o atributo para true.

Observação

Definir o atributo para true impede que CLR versão 1.1 ou CLR versão 2.0 carregue no mesmo processo, desativando efetivamente a funcionalidade lado a lado em processo (ver Execução Lado a Lado para Interoperabilidade COM).

Example

O exemplo seguinte mostra como especificar a versão de runtime num ficheiro 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