<startup> Elemento

  • Artigo

Especifica informações de inicialização do common language runtime.

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

Atributos e elementos

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

Atributos

Atributo

Descrição

useLegacyV2RuntimeActivationPolicy

Atributo opcional.

Especifica se deseja habilitar o .NET Framework versão 2.0 política de ativação de tempo de execução ou para usar o .NET Framework versão 4 política de ativação.

Atributo de useLegacyV2RuntimeActivationPolicy

Valor

Descrição

true

Habilitar .NET Framework versão 2.0 política de ativação de runtime para o runtime escolhido, o que é vincular as técnicas de ativação do legado de tempo de execução (como o CorBindToRuntimeEx função) para o runtime escolhido do arquivo de configuração em vez de capping-los na versão 2.0 do CLR. Assim, se a versão 4 ou posterior do CLR é escolhido do arquivo de configuração, os assemblies de modo misto criados com versões anteriores do.NET Framework são carregados com a versão escolhida do CLR. A definição deste valor impede a versão 1.1 do CLR ou versão 2.0 do CLR sejam carregados no mesmo processo, efetivamente, desabilitando o recurso de lado a lado no processo.

false

Use a diretiva padrão de ativação para o .NET Framework 4 e posterior, que é permitir que o runtime herdados técnicas de ativação carregar o CLR versão 1.1 ou 2.0 para o processo. A definição deste valor impede que os assemblies carregados no modo misto do.NET Framework 4 ou posterior, a menos que eles foram criados com o.NET Framework 4 ou posterior. Esse valor é o padrão.

Elementos filho

Elemento

Descrição

<requiredRuntime>

Especifica que o aplicativo oferece suporte somente a 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 CLR (common language runtime) o aplicativo oferece suporte.

Elementos pai

Elemento

Descrição

configuration

O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.

Comentários

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

O código de inicialização para um aplicativo hospedado no Microsoft Internet Explorer ignora o <startup> elemento e seus elementos filho.

O atributo useLegacyV2RuntimeActivationPolicy

Esse atributo é útil se seu aplicativo usa os caminhos do legado de ativação, como o CorBindToRuntimeEx função, e desejar que esses caminhos para ativar a versão 4 do CLR em vez de uma versão anterior, ou se o aplicativo é criado com o .NET Framework 4 , mas tem uma dependência em um assembly de modo misto, criado com uma versão anterior do.NET Framework. Nesses cenários, defina o atributo para true.

Observação

Definindo o atributo para true impede que o CLR versão 1.1 ou versão 2.0 do CLR sejam carregados no mesmo processo, efetivamente, desabilitando o recurso de lado a lado no processo (consulte Execução lado a lado para interoperabilidade COM).

Exemplo

O exemplo a seguir mostra como especificar a versão de tempo de execução 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

Referência

Esquema configurações de inicialização

Conceitos

Especificar qual versão do Runtime para uso

Outros recursos

Esquema do arquivo de configuração para o.NET Framework

Execução lado a lado para interoperabilidade COM

Execução de lado a lado no processo