Elemento <requiredRuntime>

Specifica che l'applicazione supporta solo la versione 1.0 di Common Language Runtime (CLR).

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Oggetto di descrizione
version	Attributo facoltativo. Valore della stringa che specifica la versione di .NET Framework supportata dall'applicazione corrente. Tale valore deve corrispondere al nome di directory presente nella directory radice di installazione di .NET Framework. Il contenuto del valore String non viene analizzato.
safemode	Attributo facoltativo. Specifica se il codice di avvio dell'ambiente di esecuzione consente di effettuare una ricerca nel Registro di sistema per determinare la versione dell'ambiente di esecuzione.

Attributo safemode

Value	Oggetto di descrizione
false	Il codice di avvio di runtime esegue la ricerca nel Registro di sistema. Rappresenta il valore predefinito.
true	Il codice di avvio di runtime non esegue la ricerca nel Registro di sistema.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
configuration	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
startup	Contiene l'elemento <requiredRuntime>.

Note

Nelle applicazioni compilate per supportare esclusivamente la versione 1.0 del runtime è necessario utilizzare l'elemento <requiredRuntime>. Nelle applicazioni compilate con la versione 1.1 o successive del runtime sarà necessario utilizzare l'elemento <supportedRuntime> .

Nota
Se si utilizza la funzione CorBindToRuntimeByCfg per specificare il file di configurazione, è necessario utilizzare l'elemento <requiredRuntime> per tutte le versioni del runtime.L'elemento <supportedRuntime> viene ignorato quando si utilizza CorBindToRuntimeByCfg.

La stringa dell'attributo version deve corrispondere al nome della cartella di installazione relativa alla versione di .NET Framework specificata. Tale stringa non viene interpretata. Se il codice di avvio dell'ambiente di esecuzione non individua una cartella corrispondente, l'ambiente di esecuzione non viene caricato; il codice di avvio visualizza un messaggio di errore e si interrompe.

Nota
Il codice di avvio per un'applicazione inclusa in Microsoft Internet Explorer ignora l'elemento <requiredRuntime>.

Esempio

Nell'esempio seguente viene illustrato come specificare la versione dell'ambiente di esecuzione in un file di configurazione.

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

Vedere anche

Riferimenti

Schema delle impostazioni di avvio

Concetti

Specifica della versione di runtime da utilizzare

Altre risorse

Schema dei file di configurazione per .NET Framework