<elemento di avvio>

Articolo
05/10/2023

Specifica le informazioni di avvio di Common Language Runtime.

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
`useLegacyV2RuntimeActivationPolicy`	Attributo facoltativo. Specifica se abilitare i criteri di attivazione del runtime di .NET Framework 2.0 o usare i criteri di attivazione di .NET Framework 4.

attributo useLegacyV2RuntimeActivationPolicy

Valore Descrizione

true Abilitare i criteri di attivazione del runtime di .NET Framework 2.0 per il runtime scelto, ovvero associare le tecniche di attivazione del runtime legacy (ad esempio la funzione CorBindToRuntimeEx) al runtime scelto dal file di configurazione anziché limitarli alla versione 2.0 di CLR. Pertanto, se CLR versione 4 o successiva viene scelto dal file di configurazione, gli assembly in modalità mista creati con le versioni precedenti di .NET Framework vengono caricati con la versione CLR scelta. Se si imposta questo valore, CLR versione 1.1 o CLR versione 2.0 viene caricato nello stesso processo, disabilitando in modo efficace la funzionalità side-by-side del processo.

false Usare i criteri di attivazione predefiniti per .NET Framework 4 e versioni successive, che consentono alle tecniche di attivazione del runtime legacy di caricare CLR versione 1.1 o 2.0 nel processo. L'impostazione di questo valore impedisce il caricamento di assembly in modalità mista in .NET Framework 4 o versioni successive, a meno che non siano stati compilati con .NET Framework 4 o versioni successive. Questo è il valore predefinito.

Valore	Descrizione
`true`	Abilitare i criteri di attivazione del runtime di .NET Framework 2.0 per il runtime scelto, ovvero associare le tecniche di attivazione del runtime legacy (ad esempio la funzione CorBindToRuntimeEx) al runtime scelto dal file di configurazione anziché limitarli alla versione 2.0 di CLR. Pertanto, se CLR versione 4 o successiva viene scelto dal file di configurazione, gli assembly in modalità mista creati con le versioni precedenti di .NET Framework vengono caricati con la versione CLR scelta. Se si imposta questo valore, CLR versione 1.1 o CLR versione 2.0 viene caricato nello stesso processo, disabilitando in modo efficace la funzionalità side-by-side del processo.
`false`	Usare i criteri di attivazione predefiniti per .NET Framework 4 e versioni successive, che consentono alle tecniche di attivazione del runtime legacy di caricare CLR versione 1.1 o 2.0 nel processo. L'impostazione di questo valore impedisce il caricamento di assembly in modalità mista in .NET Framework 4 o versioni successive, a meno che non siano stati compilati con .NET Framework 4 o versioni successive. Questo è il valore predefinito.

Elementi figlio

Elemento	Descrizione
<requiredRuntime>	Specifica che l'applicazione supporta solo la versione 1.0 di Common Language Runtime. Le applicazioni compilate con runtime versione 1.1 o successiva devono usare l'elemento <supportatoRuntime> .
<supportRuntime>	Specifica le versioni di Common Language Runtime supportate dall'applicazione.

Elementi padre

Elemento	Descrizione
`configuration`	Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.

Commenti

L'elemento <supportatoRuntime> deve essere usato da tutte le applicazioni compilate usando la versione 1.1 o successiva del runtime. Le applicazioni compilate per supportare solo la versione 1.0 del runtime devono usare l'elemento <requiredRuntime> .

Attributo useLegacyV2RuntimeActivationPolicy

Questo attributo è utile se l'applicazione usa percorsi di attivazione legacy, ad esempio la funzione CorBindToRuntimeEx e si desidera che tali percorsi attivino la versione 4 di CLR anziché una versione precedente o se l'applicazione viene compilata con .NET Framework 4 ma ha una dipendenza da un assembly in modalità mista compilata con una versione precedente di .NET Framework. In questi scenari impostare l'attributo su true.

Nota

L'impostazione dell'attributo per true impedire che CLR versione 1.1 o CLR versione 2.0 venga caricato nello stesso processo, disabilitando in modo efficace la funzionalità side-by-side side (vedere Esecuzione side-by-side per l'interoperabilità COM).

Esempio

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

<!-- 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>