Compartilhar via


Elemento <requiredRuntime>

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 vez dele, o elemento supportedRuntime deverá ser usado.

<configuration>
  <startup>
    <requiredRuntime>

Syntax

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

Atributos e elementos

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

Atributos

Atributo Descrição
version Atributo opcional.

Um valor de cadeia de caracteres que especifica a versão do .NET Framework a qual esse aplicativo oferece suporte. O valor da cadeia de caracteres deve corresponder ao nome do diretório encontrado na raiz da 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

Valor Descrição
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 Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
startup Contém o elemento <requiredRuntime>.

Comentários

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

Observação

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

A cadeia de caracteres do atributo version 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 mostrará uma mensagem de erro e será encerrado.

Exemplo

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>

Confira também