Partilhar via


<elemento requiredRuntime>

Especifica que a aplicação suporta apenas a versão 1.0 do runtime de linguagem comum. Este elemento foi preterido e já não deve ser utilizado. Em supportedRuntime vez disso, o elemento deve ser utilizado.

<configuração>
  <arranque>
    <requiredRuntime>

Syntax

   <requiredRuntime  
version="runtime version"
safemode="true|false"/>

Atributos e elementos

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

Atributos

Atributo Descrição
version Atributo opcional.

Um valor de cadeia que especifica a versão do .NET Framework que esta aplicação suporta. O valor da cadeia tem de corresponder ao nome do diretório encontrado na raiz de instalação .NET Framework. Os conteúdos do valor da cadeia não são analisados.
safemode Atributo opcional.

Especifica se o código de arranque do runtime procura no registo para determinar a versão do runtime.

atributo safemode

Valor Descrição
false O código de arranque do runtime é apresentado no registo. Este é o valor predefinido.
true O código de arranque do runtime não é apresentado no registo.

Elementos subordinados

Nenhum.

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.
startup Contém o <requiredRuntime> elemento .

Observações

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

Nota

Se utilizar a função CorBindToRuntimeByCfg para especificar o ficheiro de configuração, tem de utilizar o <requiredRuntime> elemento para todas as versões do runtime. O <supportedRuntime> elemento é ignorado quando utiliza CorBindToRuntimeByCfg.

A version cadeia de atributos tem de corresponder ao nome da pasta de instalação da versão especificada do .NET Framework. Esta cadeia não é interpretada. Se o código de arranque do runtime não encontrar uma pasta correspondente, o runtime não é carregado; o código de arranque mostra uma mensagem de erro e sai.

Exemplo

O exemplo seguinte mostra como especificar a versão do runtime num ficheiro de configuração.

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>

Ver também