<elemento de arranque>

Artigo
05/09/2023

Especifica informações de arranque comuns do runtime de linguagem.

Syntax

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

Atributos e elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`useLegacyV2RuntimeActivationPolicy`	Atributo opcional. Especifica se pretende ativar o .NET Framework política de ativação de runtime 2.0 ou utilizar a política de ativação .NET Framework 4.

useLegacyV2RuntimeActivationPolicy attribute (utilizar o atributoLegacyV2RuntimeActivationPolicy)

Valor Descrição

true Ative .NET Framework política de ativação do runtime 2.0 para o runtime escolhido, que consiste em vincular técnicas de ativação do runtime legado (como a função CorBindToRuntimeEx) ao runtime escolhido a partir do ficheiro de configuração em vez de as limitar na versão 2.0 do CLR. Assim, se a versão CLR 4 ou posterior for escolhida a partir do ficheiro de configuração, as assemblagens de modo misto criadas com versões anteriores do .NET Framework são carregadas com a versão CLR escolhida. Definir este valor impede que a versão CLR 1.1 ou CLR versão 2.0 seja carregada para o mesmo processo, desativando efetivamente a funcionalidade no processo lado a lado.

false Utilize a política de ativação predefinida para o .NET Framework 4 e posterior, que consiste em permitir que técnicas de ativação do runtime legado carreguem a versão CLR 1.1 ou 2.0 para o processo. Definir este valor impede que as assemblagens de modo misto sejam carregadas para a .NET Framework 4 ou posterior, a menos que tenham sido criadas com o .NET Framework 4 ou posterior. este valor é a predefinição.

Valor	Descrição
`true`	Ative .NET Framework política de ativação do runtime 2.0 para o runtime escolhido, que consiste em vincular técnicas de ativação do runtime legado (como a função CorBindToRuntimeEx) ao runtime escolhido a partir do ficheiro de configuração em vez de as limitar na versão 2.0 do CLR. Assim, se a versão CLR 4 ou posterior for escolhida a partir do ficheiro de configuração, as assemblagens de modo misto criadas com versões anteriores do .NET Framework são carregadas com a versão CLR escolhida. Definir este valor impede que a versão CLR 1.1 ou CLR versão 2.0 seja carregada para o mesmo processo, desativando efetivamente a funcionalidade no processo lado a lado.
`false`	Utilize a política de ativação predefinida para o .NET Framework 4 e posterior, que consiste em permitir que técnicas de ativação do runtime legado carreguem a versão CLR 1.1 ou 2.0 para o processo. Definir este valor impede que as assemblagens de modo misto sejam carregadas para a .NET Framework 4 ou posterior, a menos que tenham sido criadas com o .NET Framework 4 ou posterior. este valor é a predefinição.

Elementos subordinados

Elemento	Descrição
<requiredRuntime>	Especifica que a aplicação suporta apenas a versão 1.0 do runtime de linguagem comum. As aplicações criadas com a versão 1.1 ou posterior do runtime devem utilizar o <elemento supportedRuntime> .
<supportedRuntime>	Especifica as versões do runtime de linguagem comum que a aplicação suporta.

Elementos principais

Elemento	Descrição
`configuration`	O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.

Observações

O <elemento supportedRuntime> deve ser utilizado por todas as aplicações criadas com a versão 1.1 ou posterior do runtime. As aplicações criadas para suportar apenas a versão 1.0 do runtime têm de utilizar o <elemento requiredRuntime> .

O atributo useLegacyV2RuntimeActivationPolicy

Este atributo é útil se a sua aplicação utilizar 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 criada com o .NET Framework 4, mas tiver uma dependência numa assemblagem de modo misto criada com uma versão anterior do .NET Framework. Nesses cenários, defina o atributo como true.

Nota

Definir o atributo para true impedir que a versão CLR 1.1 ou CLR versão 2.0 seja carregada para o mesmo processo, desativando efetivamente a funcionalidade lado a lado no processo (veja Execução Lado a Lado para Interoperabilidade COM).

Exemplo

O exemplo seguinte mostra como especificar a versão do 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>

Partilhar via