Elemento <startup>

Artigo
03/30/2023

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

Syntax

<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 a política de ativação do runtime do .NET Framework 2.0 deve ser habilitada ou usar a política de ativação .NET Framework 4.

atributo useLegacyV2RuntimeActivationPolicy

Valor Descrição

true Habilite .NET Framework política de ativação do runtime 2.0 para o runtime escolhido, que é associar técnicas de ativação de runtime herdadas (como a função CorBindToRuntimeEx) ao runtime escolhido no arquivo de configuração em vez de encadeá-las na versão 2.0 do CLR. Portanto, se a versão 4 ou posterior do CLR for escolhida no 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 herdadas para carregar o 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. Este é o valor padrão.

Valor	Descrição
`true`	Habilite .NET Framework política de ativação do runtime 2.0 para o runtime escolhido, que é associar técnicas de ativação de runtime herdadas (como a função CorBindToRuntimeEx) ao runtime escolhido no arquivo de configuração em vez de encadeá-las na versão 2.0 do CLR. Portanto, se a versão 4 ou posterior do CLR for escolhida no 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 herdadas para carregar o 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. Este é o valor padrão.

Elementos filho

Elemento	Descrição
<requiredRuntime>	Especifica que o aplicativo dá suporte apenas à versão 1.0 do Common Language Runtime. Os aplicativos criados com a versão 1.1 do tempo de execução devem usar o elemento <supportedRuntime>.
<supportedRuntime>	Especifica a quais versões do Common Language Runtime o aplicativo oferece suporte.

Elementos pai

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

Comentários

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

O atributo useLegacyV2RuntimeActivationPolicy

Este atributo é útil se o seu aplicativo usa caminhos de ativação herdados, como a função CorBindToRuntimeEx, e você desejar esses caminhos para ativar a versão 4 do CLR em vez de uma versão anterior, ou se seu aplicativo for criado com .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).

Exemplo

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>

Compartilhar via