Compartilhar via


<requiredRuntime> elemento

Especifica que o aplicativo dá suporte apenas à versão 1.0 do common language runtime. Esse elemento foi preterido e não deve mais ser usado. Em supportedRuntime vez disso, o elemento deve ser usado.

<configuração><inicialização><requiredRuntime>

Sintaxe

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

Atributos e elementos

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

Attributes

Attribute Description
version Atributo opcional.

Um valor de cadeia de caracteres que especifica a versão do .NET Framework compatível com esse aplicativo. O valor da cadeia de caracteres deve corresponder ao nome do diretório encontrado na raiz de instalação do .NET Framework. O conteúdo do valor da cadeia de caracteres não é analisado.
safemode Atributo opcional.

Especifica se o código de inicialização do runtime pesquisa o Registro para determinar a versão do runtime.

atributo safemode

Value Description
false O código de inicialização de runtime procura no registro. Esse é o valor padrão.
true O código de inicialização de runtime não procura no Registro.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
startup Contém o <requiredRuntime> elemento.

Observações

Os aplicativos criados para dar suporte somente à versão 1.0 do runtime devem usar o <requiredRuntime> elemento. Os aplicativos criados usando a versão 1.1 ou posterior do runtime devem usar o <supportedRuntime> elemento.

Observação

Se você usar a função CorBindToRuntimeByCfg para especificar o arquivo de configuração, deverá usar o <requiredRuntime> elemento para todas as versões do runtime. O <supportedRuntime> elemento é ignorado quando você usa CorBindToRuntimeByCfg.

A version cadeia de caracteres de atributo deve corresponder ao nome da pasta de instalação para a versão especificada do .NET Framework. Essa cadeia de caracteres não é interpretada. Se o código de inicialização do runtime não encontrar uma pasta correspondente, o runtime não será carregado; o código de inicialização mostra uma mensagem de erro e é encerrado.

Example

O exemplo a seguir mostra como especificar a versão de runtime em um arquivo de configuração.

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

Consulte também