Guida per gli sviluppatori di applicazioni sulla distribuzione di .NET Framework 3.5

In Microsoft .NET Framework versione 3.5 è disponibile un programma di installazione ridistribuibile che include anche i Service Pack e gli aggiornamenti cumulativi per .NET Framework 2.0 e 3.0.

In questo argomento viene illustrato come ridistribuire .NET Framework con le applicazioni. Include le sezioni seguenti:

• Formati disponibili

• Informazioni per ottenere il pacchetto ridistribuibile per .NET Framework 3.5

• Requisiti per l'installazione

• Installazione manuale di .NET Framework

• Concatenamento del package ridistribuibile nell'installazione dell'applicazione

• Installazione di .NET Framework 3.5 per applicazioni Web

• Rilevamento di .NET Framework 3.5

• Opzioni della riga di comando

• Codici errore

• Appendice: componenti .NET Framework 3.5

• Appendice: esempi di installazione

Formati disponibili

.NET Framework 3.5 Redistributable Package è disponibile nei due formati seguenti:

• dotnetfx35.exe  File eseguibile autonomo che contiene tutti i componenti necessari per la distribuzione in piattaforme a 32 bit e a 64 bit in tutti i sistemi operativi supportati. Il file eseguibile non contiene i Language Pack. Per impostazione predefinita viene scaricato e installato il Language Pack corrispondente alla lingua del sistema operativo dell'utente. I Language Pack di .NET Framework versione 3.5 sono disponibili come file eseguibili autonomi distinti per ogni lingua nell'Area Download Microsoft.

• dotnetfx35setup.exe  Programma di avvio automatico leggero che scarica i componenti necessari dal Web durante l'installazione. Il file eseguibile non contiene i componenti .NET Framework versione 3.5. Vengono rilevati, scaricati e installati solo i componenti necessari dal Web. Il programma di avvio automatico inoltre scarica e installa il Language Pack che corrisponde alla lingua del sistema operativo dell'utente. È possibile utilizzare Language Pack autonomi per installare il supporto di lingue aggiuntive.

È possibile utilizzare uno dei due package in piattaforme sia a 32 che a 64 bit in tutti i sistemi operativi supportati.

Il componente ridistribuibile può essere avviato e installato manualmente in un computer oppure può essere avviato e installato come parte del programma di installazione di un'applicazione .NET Framework 3.5.

Nota:
Per installare .NET Framework 3.5 è necessario disporre di privilegi di amministratore.

Informazioni per ottenere il pacchetto ridistribuibile per .NET Framework 3.5

È possibile scaricare il pacchetto ridistribuibile per Microsoft .NET Framework 3.5 dall'Area Download Microsoft. Il pulsante Download nella parte superiore della pagina consente di installare il programma di avvio automatico (dotNetFx35setup.exe). Per scaricare il pacchetto di installazione completo, scorrere fino al collegamento per il pacchetto ridistribuibile completo nella parte inferiore della pagina.

Requisiti per l'installazione

In questa sezione vengono riepilogati i requisiti hardware e software per l'installazione di .NET Framework 3.5. Se i requisiti minimi non vengono soddisfatti, l'installazione verrà bloccata dal processo di installazione di .NET Framework.

Per un elenco dettagliato dei requisiti software e hardware, vedere Requisiti di sistema per la versione 3.5.

Requisiti software

Per .NET Framework 3.5 è necessario che nel computer di destinazione sia disponibile uno dei sistemi operativi seguenti:

• Windows XP Home o Windows XP Professional, entrambi con Service Pack 2 o versione successiva.

• Famiglia Windows Server 2003 con Service Pack 1 o successiva.

• Windows Vista.

• Windows Server 2008.

  Nota:
  .NET Framework 3.5 supporta l'architettura IA64 solo in Microsoft Windows Server 2008.

Requisiti hardware

Nella tabella seguente sono elencati i requisiti di CPU e RAM per l'esecuzione di .NET Framework 3.5.

Installazione manuale di .NET Framework

In alcune situazioni, l'installazione automatica di .NET Framework 3.5 con l'applicazione potrebbe risultare poco pratica. In tal caso gli utenti possono installare .NET Framework personalmente dall'Area download Microsoft. Pertanto, nel processo di installazione è necessario fornire istruzioni sulle modalità con cui gli utenti possono individuare e installare .NET Framework.

Nota:
Non inserire il pacchetto ridistribuibile nella rete. Indirizzare gli utenti all'Area download Microsoft.

Concatenamento del pacchetto ridistribuibile nell'installazione dell'applicazione

In .NET Framework 3.5 sono disponibili tre modalità per includere ("concatenare") il processo di installazione di .NET Framework nel processo di installazione dell'applicazione:

• Opzione 1. Consentire al processo di installazione di .NET Framework di stabilire quali componenti sono necessari e di scaricare e installare solo tali componenti dal Web.

  Per consentire al processo di installazione di individuare, scaricare e installare solo i componenti necessari, utilizzare il pacchetto dotnetfx35setup.exe. Per concatenare il processo di installazione di .NET Framework, aggiungere il comando seguente al processo di installazione dell'applicazione:

  dotnetfx35setup.exe /q /norestart

• Opzione 2. Includere l'insieme completo dei file di .NET Framework nel supporto di ridistribuzione, in modo che gli utenti non debbano scaricare file aggiuntivi dal Web durante l'installazione.

  Se si desidera includere tutti i componenti nel processo di installazione di .NET Framework, utilizzare il file eseguibile autonomo completo (dotnetfx35.exe). Il pacchetto include i componenti necessari per installare .NET Framework 3.5 in computer x86, x64 e IA64 in tutti i sistemi operativi supportati. Utilizzare questo pacchetto se lo spazio o il tempo di download non costituiscono un problema per la distribuzione dell'applicazione. Per concatenare questo processo di installazione di .NET Framework, utilizzare il comando seguente:

  dotnetfx35.exe /q /norestart

• Opzione 3. Includere i componenti richiesti più di frequente per gli utenti e consentire al processo di installazione di .NET di individuare eventuali componenti mancanti e scaricarli dal Web. Questo scenario è più appropriato se l'applicazione viene distribuita in una piattaforma, in un sistema operativo o in una configurazione di sistema utente specifici.

  Per eseguire questa installazione, è necessario dapprima ottenere il file eseguibile autonomo completo ed estrarre i file tramite il comando seguente:

  dotnetfx35.exe /x extract-location

  Dopo aver estratto i file, verrà visualizzata una struttura di file e cartelle con l'elenco dei file relativi a ogni componente di .NET Framework 3.5, come illustrato nell'Appendice di questo documento.

  Per distribuire .NET Framework 3.5, includere i componenti appropriati nella struttura di cartelle creata con il processo di estrazione, quindi concatenarli nell'installazione del programma di avvio automatico di .NET Framework tramite il comando seguente:

  dotnetfx35setup.exe /q /norestart

  Nell'Appendice di questo documento sono riportati due esempi dei componenti da includere nel layout.

Indipendentemente dalla modalità scelta, per concatenare il processo di installazione di .NET Framework 3.5, eseguire il pacchetto ridistribuibile dalla riga di comando e utilizzare le opzioni da riga di comando /q e /norestart.

Nota:
Per evitare di scaricare e installare automaticamente i Language Pack, utilizzare l'opzione da riga di comando /lang:ita.

Installazione di .NET Framework 3.5 per applicazioni Web

Per le applicazioni Web che si basano sulle funzionalità di .NET Framework 3.5 potrebbe essere necessario scaricare e installare .NET Framework nel computer dell'utente. È possibile determinare se .NET Framework 3.5 è installato nel computer dell'utente attenendosi alle istruzioni presenti nella sezione successiva. Se non è installata la versione corretta di .NET Framework, è possibile indirizzare gli utenti all'Area download Microsoft per ottenere il pacchetto .NET Framework 3.5.

Rilevamento di .NET Framework 3.5

È possibile rilevare se .NET Framework 3.5 è già installato leggendo una chiave del Registro di sistema o eseguendo una query sulla stringa agente utente in Internet Explorer.

Lettura delle chiavi del Registro di sistema

Il programma di installazione di .NET Framework 3.5 scrive chiavi del Registro di sistema al termine dell'installazione. È possibile verificare se .NET Framework 3.5 è installato controllando le chiavi del Registro di sistema elencate nella tabella seguente.

Lettura della stringa agente utente in un browser

Quando .NET Framework 3.5 viene installato in un computer, il relativo numero di versione viene visualizzato all'interno della stringa dell'agente utente riportata nelle intestazioni del browser. Di seguito è illustrata una pagina di esempio in cui viene utilizzato JavaScript per rilevare e segnalare se .NET Framework 3.5 è installato.

<html>
  <head>
    <title>Test for .NET Framework 3.5</title>
    <meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <script type="text/JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.5.21022";
    
    function body_onload()
    {
      var result = document.getElementById("result");
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
          result.innerHTML = "This machine has the correct version of the .NET Framework 3.5 runtime: " 
          + NETFX3RuntimeVersion + "." 
          + "\n\nThis machine's userAgent string is: " 
          + navigator.userAgent + ".";
      } 
      else
      {
        result.innerHTML = "The .NET Framework version 3.5 is not installed on this computer.<br/>"
            + "Click <a href='https://go.microsoft.com/fwlink/?LinkId=96339'"
            + " here</a> to get the .NET Framework 3.5 now.";}
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = 
           navigator.userAgent.match(/.NET CLR 3.5.[0-9]+/g);
      if (userAgentString != null)
      {
        var i;
        for (i = 0; i < userAgentString.length; ++i)
        {
          if (CompareVersions(GetVersion(versionToCheck), 
                GetVersion(userAgentString[i])) <= 0)
            return true;
        }
      }
      return false;
    }

    //
    // Extract the numeric part of the version string.
    //
    function GetVersion(versionString)
    {
      var numericString = versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);
      return numericString.slice(1);
    }

    //
    // Compare the version strings by converting them to numeric format.
    //
    function CompareVersions(version1, version2)
    {
      for (i = 0; i < version1.length; ++i)
      {
        var number1 = new Number(version1[i]);
        var number2 = new Number(version2[i]);

        if (number1 < number2)
          return -1;
        if (number1 > number2)
          return 1;
      }
      return 0;
    }
    
    -->
    </script>
  </head>
  
  <body onload="body_onload();">
    <div id="result" ></div>
  </body>
</html>

Se la ricerca della stringa della versione di ".NET Framework 3.5" ha esito positivo, viene visualizzato il messaggio seguente:

This machine has the correct version of the .NET Framework 3.5 runtime: 3.5.28015.00.
This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 3.5.28015.00).

I dettagli della stringa agente utente variano leggermente a seconda del tipo e della versione del browser utilizzato per verificare la presenza di .NET Framework.

Se .NET Framework 3.5 non è installato, viene visualizzato il messaggio seguente:

The .NET Framework version 3.5 is not installed on this computer. Click here to get the .NET Framework 3.5 now.

Opzioni della riga di comando

Nella tabella seguente sono elencate le opzioni che è possibile specificare quando si esegue il programma di installazione di .NET Framework 3.5 Redistributable dalla riga di comando.

Codici errore

Nella tabella seguente sono elencati i codici di errore che possono essere restituiti dal programma di installazione di .NET Framework 3.5 Redistributable. I codici di errore sono uguali per tutte le versioni del programma di installazione.

Appendice

Nelle tabelle fornite in questa appendice i sistemi operativi sono stati abbreviati come indicato di seguito:

• XP = Windows XP

• Vista = Windows Vista

• W2K3 = Windows Server 2003

• W2K8 = Windows Server 2008

Componenti .NET Framework 3.5

Nella tabella seguente sono elencati i componenti di .NET Framework versione 3.5.

Esempi di installazione

Negli esempi seguenti sono elencati i file che è necessario includere nel supporto di installazione per due differenti scenari di installazione.

Nota:
Se si includono singoli componenti, è necessario inserirli nello stesso percorso relativo del programma di avvio automatico dell'installazione di .NET Framework 3.5 (dotNetFx35setup.exe).

Esempio 1

Nella tabella seguente sono elencati i file che è necessario includere nel layout del supporto di installazione per eseguire la distribuzione in Windows XP o Windows Vista. Per questo elenco di file si presuppone che gli utenti installino solo la versione x86 e che abbiano già installato .NET Framework 2.0 SP1 e .NET Framework 3.0 SP1 (per Windows XP e Windows Server 2003) o l'aggiornamento cumulativo (per Windows Vista).

Esempio 2

Nella tabella seguente sono elencati i file che è necessario includere nel layout del supporto di installazione per eseguire la distribuzione in Windows XP SP2 o Windows Server 2003 SP1 nei computer x86 e x64. Per questo elenco di file si presuppone che gli utenti abbiano già installato .NET Framework versione 2.0 SP1.

Nota:
In questo esempio, se l'utente non dispone di .NET Framework 2.0 SP1, il programma di installazione lo scaricherà automaticamente se è disponibile una connessione Internet.

Vedere anche

Concetti

Guida alla distribuzione di .NET Framework 3.5 per amministratori