Condividi tramite

Procedura: Configurare un'app per supportare .NET Framework 4 o versioni successive

Tutte le app che ospitano Common Language Runtime (CLR) devono avviare o attivare CLR per eseguire codice gestito. In genere, un'app .NET Framework viene eseguita nella versione di CLR su cui è stata compilata, ma è possibile modificare questo comportamento per le app desktop usando un file di configurazione dell'applicazione (talvolta definito file di app.config ). Tuttavia, non è possibile modificare il comportamento di attivazione predefinito per le app di Windows Store o le app di Windows Phone usando un file di configurazione dell'applicazione. Questo articolo illustra come abilitare l'esecuzione dell'app desktop in un'altra versione di .NET Framework e fornisce un esempio di come usare la versione 4 o versioni successive di destinazione.

La versione di .NET Framework in cui viene eseguita un'app è determinata nell'ordine seguente:

  • File di configurazione.

    Se il file di configurazione dell'applicazione include <voci supportedRuntime> che specificano una o più versioni di .NET Framework e una di queste versioni è presente nel computer dell'utente, l'app viene eseguita in tale versione. Il file di configurazione legge le voci <supportedRuntime> nell'ordine in cui sono elencate, utilizzando la prima versione di .NET Framework elencata che è presente nel computer dell'utente. Usare l'elemento <requiredRuntime> per la versione 1.0.

  • Versione compilata.

    Se non è presente alcun file di configurazione, ma la versione di .NET Framework su cui è stata compilata l'app è presente nel computer dell'utente, l'app viene eseguita in tale versione.

  • Versione più recente installata.

    Se la versione di .NET Framework su cui è stata compilata l'app non è presente e un file di configurazione non specifica una versione in un <supportedRuntime> elemento, l'app tenta di eseguire nella versione più recente di .NET Framework presente nel computer dell'utente.

    Tuttavia, le app .NET Framework 1.0, 1.1, 2.0, 3.0 e 3.5 non vengono eseguite automaticamente in .NET Framework 4 o versioni successive e, in alcuni casi, l'utente potrebbe ricevere un errore e potrebbe essere richiesto di installare .NET Framework 3.5. Il comportamento di attivazione può dipendere anche dal sistema operativo dell'utente, perché versioni diverse del sistema Windows includono versioni diverse di .NET Framework. Se l'app supporta sia .NET Framework 3.5 che 4 o versione successiva, è consigliabile indicare questa operazione con più voci nel file di configurazione per evitare errori di inizializzazione di .NET Framework. Per altre informazioni, vedere Versioni e dipendenze.

È anche possibile configurare le app .NET Framework 3.5 da eseguire in .NET Framework 4 o versioni successive, anche nei computer in cui è installato .NET Framework 3.5, per sfruttare i miglioramenti delle prestazioni nelle versioni 4 e successive.

Importante

È consigliabile testare sempre l'app in ogni versione di .NET Framework supportata. Vedere Compatibilità delle versioni per informazioni sull'aggiornamento dell'applicazione per supportare le versioni successive di .NET Framework.

Per informazioni sulla modifica delle app .NET Framework 1.0 e 1.1 per supportare Windows 7 e Windows 8, vedere Migrazione da .NET Framework 1.1.

Esegui l'app su .NET Framework 4.x

  1. Aggiungere o individuare il file di configurazione per il progetto .NET Framework.

    Il file di configurazione per un'app è un file XML che si trova nella stessa directory e ha lo stesso nome di file dell'app, ma con un'estensione .config . Ad esempio, per un'app denominata MyExecutable.exe, il file di configurazione dell'applicazione è denominato MyExecutable.exe.config.

    Per aggiungere un file di configurazione in Visual Studio, individuare la barra dei menu e selezionare Progetto>Aggiungi nuovo elemento. Scegliere Generale nel riquadro sinistro e quindi selezionare File di configurazione. Assegnare al file di configurazione il nome App.config. Queste opzioni di menu non sono disponibili per le app di Windows Store perché non è possibile modificare i criteri di attivazione in tale piattaforma.

  2. Aggiungere l'elemento <supportedRuntime> come segue al file di configurazione dell'applicazione:

    <configuration>
  <startup>
    <supportedRuntime version="version"/>
  </startup>
</configuration>

    L'attributo version specifica la versione CLR allineata alla versione di .NET Framework supportata dall'app. Usare le stringhe seguenti:

    • .NET Framework 1.0: "v1.0.3705"
    • .NET Framework 1.1: "v1.1.4322"
    • .NET Framework 2.0, 3.0 e 3.5: "v2.0.50727"
    • .NET Framework 4 e versioni successive: "v4.0"

    È possibile aggiungere più <elementi SupportedRuntime> , elencati in ordine di preferenza, per specificare il supporto per più versioni di .NET Framework.

La tabella seguente illustra come le impostazioni dei file di configurazione dell'applicazione e le versioni di .NET Framework installate in un computer determinano la versione in cui viene eseguita un'app .NET Framework 3.5. Gli esempi sono specifici di un'applicazione .NET Framework 3.5, ma è possibile usare una logica simile alle applicazioni di destinazione compilate con le versioni precedenti di .NET Framework. Si noti che il numero di versione di .NET Framework 2.0 (v2.0.50727) viene usato per specificare .NET Framework 3.5 nel file di configurazione dell'applicazione.

Impostazione del file dell'app.config Nel computer con installata la versione 3.5 Sul computer con le versioni 3.5 e 4 o versioni successive installate Sul computer con la versione 4 o successiva installata
None Viene eseguito nella versione 3.5 Viene eseguito nella versione 3.5 Visualizza il messaggio di errore che richiede all'utente di installare la versione corretta*
<supportedRuntime version="v2.0.50727"/> Viene eseguito nella versione 3.5 Viene eseguito nella versione 3.5 Visualizza il messaggio di errore che richiede all'utente di installare la versione corretta*
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>		 Viene eseguito nella versione 3.5 Viene eseguito nella versione 3.5 Compatibile con versione 4 o successive
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>		 Viene eseguito nella versione 3.5 Funziona su 4 o versioni successive Funziona su versioni 4 o successive
<supportedRuntime version="v4.0"/> Visualizza il messaggio di errore che richiede all'utente di installare la versione corretta* Funziona su versione 4 o successive Funziona su versione 4 o successive

* Per altre informazioni su questo messaggio di errore e su come evitarlo, vedere Errori di inizializzazione di .NET Framework: Gestione dell'esperienza utente.

Vedere anche

  • Last updated on