Guida alla distribuzione di Microsoft .NET Framework 3.0

Microsoft Corporation

Luglio 2006

Contenuto

Riepilogo
Introduzione
Requisiti di installazione
   Requisiti software
   Requisiti hardware
Dove ottenere il pacchetto ridistribuibile di .NET Framework 3.0
Ridistribuzione di .NET Framework 3.0 tramite un progetto di installazione di Visual Studio 2005
Installazione manuale di .NET Framework da parte degli utenti
Concatenamento del pacchetto ridistribuibile nella configurazione dell'applicazione
Ridistribuzione di .NET Framework 3.0 per applicazioni Web
Rilevamento di Microsoft .NET Framework 3.0
   Lettura delle chiavi del Registro di sistema
   Lettura della stringa dell'agente utente in Internet Explorer
Opzioni della riga di comando per .NET Framework 3.0 Redistributable
Codici di errore per .NET Framework 3.0 Redistributable

Riepilogo

Questo articolo descrive come distribuire applicazioni Microsoft .NET Framework 3.0 con Dotnetfx3.exe, il pacchetto ridistribuibile di .NET Framework 3.0. (10 pagine stampate)

Nota Questa documentazione può includere informazioni per gli scenari che illustrano la distribuzione, ma la documentazione non concede diritti per l'uso o la distribuzione di alcuna parte dei componenti. L'uso dei componenti è soggetto al contratto di licenza per i componenti. Esaminare il contratto di licenza componenti per comprendere i diritti e le condizioni per l'utilizzo.

Introduzione

In Microsoft.NET Framework 3.0 è disponibile un programma di installazione ridistribuibile che contiene associazioni .NET Framework 2.0 alle API di Windows Vista necessarie per eseguire applicazioni .NET Framework 3.0.

Il pacchetto ridistribuibile di .NET Framework 3.0 è disponibile come file eseguibile autonomo. Il nome del file dipende dal tipo della piattaforma di destinazione. Per le piattaforme a 32 bit, il file viene denominato Dotnetfx3.exe. Per le piattaforme a 64 bit, il file viene denominato Dotnetfx3_x64.exe. È anche possibile distribuire un piccolo pacchetto ridistribuibile denominato Dotnet3setup.exe che scarica i componenti necessari durante l'installazione.

Nota Il supporto di IA64 in .NET Framework 3.0 è limitato al codice di Microsoft Windows Server denominato "Longhorn". Longhorn include già .NET Framework 3.0, quindi non è necessario alcun pacchetto ridistribuibile.

È possibile avviare e installare manualmente il ridistribuibile in un computer oppure può essere avviato e installato come parte del programma di installazione per un'applicazione .NET Framework 3.0.

Nota Per installare .NET Framework 3.0 sono necessari privilegi di amministratore.

Requisiti di installazione

Questa sezione descrive i requisiti software e hardware per un computer in cui deve essere installato il pacchetto ridistribuibile di Microsoft .NET Framework 3.0. Se i requisiti minimi non sono soddisfatti, Dotnetfx3.exe bloccherà l'installazione del pacchetto ridistribuibile.

Requisiti software

Per installare Microsoft .NET Framework 3.0, è necessario installare uno dei sistemi operativi seguenti nel computer di destinazione:

• Microsoft Windows XP Home o Microsoft Windows XP Professional, entrambi con Service Pack 2 o versione successiva.
• Famiglia microsoft Windows Server 2003 con Service Pack 1 o versione successiva.

Per Microsoft Windows Vista (non inclusa la piattaforma IA64) e Microsoft Windows Server con il nome di codice "Longhorn" IA64 Edition, .NET Framework 3.0 è una funzionalità del sistema operativo.

Requisiti hardware

La tabella seguente elenca i requisiti hardware per l'esecuzione di .NET Framework 3.0.

Dove ottenere il pacchetto ridistribuibile di .NET Framework 3.0

È possibile scaricare il pacchetto ridistribuibile di Microsoft .NET Framework 3.0 dall'Area download di Microsoft Vista o dal sito Web di Microsoft Windows Update.

Nota Il sito di Microsoft Windows Update offre solo la versione ufficialmente rilasciata di .NET Framework 3.0. Non offre versioni beta.

Se è necessario che gli utenti installino Microsoft .NET Framework 3.0 da Internet, non pubblicare il pacchetto ridistribuibile nella propria rete. In alternativa, indirizzare gli utenti all'Area download di Microsoft Vista o al sito Web di Microsoft Windows Update.

Ridistribuzione di .NET Framework 3.0 tramite un progetto di installazione di Visual Studio 2005

Quando si distribuiscono applicazioni create con Visual Studio 2005 e che richiedono .NET Framework 3.0, .NET Framework deve essere installato nel computer di destinazione prima dell'installazione dell'applicazione. È possibile includere .NET Framework 3.0 in un file eseguibile di installazione creato usando un progetto di installazione di Visual Studio 2005. In caso contrario, è possibile che gli utenti installino manualmente .NET Framework, come descritto più avanti.

Quando si configura un progetto di installazione di Visual Studio 2005 per installare Microsoft .NET Framework 3.0 con l'applicazione, .NET Framework 3.0 viene in pacchetto con l'applicazione. Una condizione di avvio nei controlli di installazione dell'applicazione whether.NET Framework 3.0 è installata e, se necessario, il processo di installazione installa .NET Framework prima di installare l'applicazione. Microsoft .NET Framework 3.0 controlla a sua volta whether.NET Framework 2.0 è installato. In caso contrario, il processo di installazione richiede all'utente di installare anche la versione precedente di .NET Framework.

Per includere .NET Framework 3.0 con il processo di installazione dell'applicazione, le estensioni facoltative di Visual Studio per .NET Framework 3.0 devono essere installate nel computer in cui si crea il progetto di installazione.

Per determinare se sono installate le estensioni di Visual Studio per .NET Framework 3.0

1. In Windows Pannello di controllo fare clic su Installazione applicazioni.
2. Nella finestra di dialogo Installazione applicazioni esaminare l'elenco Programmi attualmente installati per Le estensioni di Microsoft Visual Studio 2005 per .NET Framework 3.0.

Se le estensioni di Visual Studio 2005 per .NET Framework 3.0 non sono elencate, è possibile scaricare e installare il pacchetto delle estensioni come parte di Strumenti di sviluppo per WinFX, disponibile nella pagina Microsoft Visual Studio Code Name "Orcas" Community Technology Preview - Development Tools for WinFX nell'Area download Microsoft.

Quando si è certi di avere installato il pacchetto Estensioni di Visual Studio per .NET Framework 3.0 nel computer, è possibile creare un progetto di installazione che include .NET Framework 3.0.

Per includere .NET Framework 3.0 con un progetto di installazione

1. In Visual Studio 2005 creare un nuovo progetto di installazione seguendo questa procedura:

   1. Scegliere Nuovo dal menu File e quindi fare clic su Progetto.
   2. In Altri tipi di progetto selezionare Installazione e distribuzione.
   3. Assegnare un nome al progetto e fare clic su OK.

2. Aggiungere l'output del progetto, unire moduli, file e assembly.

3. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto e quindi scegliere Proprietà.

   Viene visualizzata la finestra di dialogo Pagine delle proprietà.

4. Fare clic su Prerequisiti.

5. Selezionare la casella di controllo Crea programma di installazione per installare i componenti prerequisiti .

6. Nell'elenco individuare Microsoft .NET Framework 3.0 e quindi selezionare la versione appropriata per le piattaforme di destinazione.

7. Specificare il percorso di origine per i prerequisiti.

   Per il percorso di .NET Framework 3.0, è possibile specificare il sito di download di Windows Vista o un sito personalizzato. L'URL può anche specificare un CD in cui viene distribuita l'applicazione.

8. Fare clic su OK.

Installazione manuale di .NET Framework da parte degli utenti

In alcune situazioni, potrebbe essere poco pratico installare automaticamente .NET Framework 3.0 con l'applicazione. In tali casi, è possibile l'installazione manuale di .NET Framework da parte degli utenti. La ridistribuibile è disponibile da diverse origini, come indicato in precedenza nella sezione Dove ottenere the.NET Framework 3.0 Redistributable Package. Tuttavia, non è consigliabile presupporre che gli utenti dell'applicazione sappiano dove ottenerlo o come installarlo. Quindi, nel processo di installazione è necessario fornire istruzioni sulle modalità con cui gli utenti dovranno individuare e installare .NET Framework.

Concatenamento del pacchetto ridistribuibile nella configurazione dell'applicazione

Se non si vuole creare un progetto di installazione di Visual Studio o se gli utenti installano manualmente .NET Framework 3.0, è possibile concatenare il processo di installazione di .NET Framework 3.0 come parte della configurazione dell'applicazione. Per concatenare il processo di installazione di .NET Framework 3.0, è possibile eseguire il ridistribuibile dalla riga di comando e usare l'opzione della riga di comando di installazione invisibile all'utente seguente:

/q /norestart

Ridistribuzione di .NET Framework 3.0 per applicazioni Web

Nelle applicazioni basate sul Web che si basano sulle funzionalità di .NET Framework 3.0, potrebbe essere necessario scaricare e installare .NET Framework nel computer dell'utente. È possibile determinare se .NET Framework 3.0 è installato nel computer dell'utente eseguendo una query sulla stringa dell'agente utente nell'intestazione del browser. Se la versione corretta di .NET Framework non è installata, è possibile indirizzare gli utenti all'Area download di .NET Framework 3.0 per ottenere il pacchetto .NET Framework 3.0.

Rilevamento di Microsoft .NET Framework 3.0

È possibile rilevare se .NET Framework 3.0 è installato leggendo una chiave del Registro di sistema ed eseguendo una query sulla stringa dell'agente utente in Internet Explorer.

Lettura delle chiavi del Registro di sistema

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

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform

Lettura della stringa dell'agente utente in Internet Explorer

Quando .NET Framework 3.0 è installato in un computer, il numero di versione di .NET Framework 3.0 viene visualizzato come parte della stringa dell'agente utente segnalata nelle intestazioni del browser. L'esempio seguente mostra una pagina di esempio che usa JavaScript per rilevare e segnalare whether.NET Framework 3.0 è installato.

Nota Questa pagina di esempio richiede Internet Explorer.

<HTML>
  <HEAD>
    <TITLE>Test for .NET Framework 3.0</TITLE>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />
    <SCRIPT LANGUAGE="JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.0.50727";
    
    function window::onload()
    {
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
result.innerText = "This machine has the correct version of the .NET 
Framework 3.0 runtime: " + NETFX3RuntimeVersion + "."  + "\n\nThis 
machine's userAgent string is: " + navigator.userAgent + ".";
      } 
      else
      {
        document.write("The .NET Framework version 3.0 is not installed on this computer.<br/>"
+ "<a href='https://msdn.microsoft.com/windowsvista/default.aspx'>"
+ "Click here to get</a> .NET Framework 3.0 now.");      }
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = navigator.userAgent.match(/.NET Framework 3.0 RunTime [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>
    <div id="result" />
  </BODY>
</HTML>

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

This machine has the correct version of the .NET Framework 3.0: 3.0.50727.
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.0.50727).

In caso contrario, viene visualizzato il messaggio seguente:

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

Opzioni della riga di comando per .NET Framework 3.0 Redistributable

Nella tabella seguente sono elencate le opzioni che è possibile includere quando si esegue il programma di installazione ridistribuibile di .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe o Dotnet3setup.exe) dalla riga di comando.

/q

/quiet

/qb

/passive

/uninstall

/remove

/f

/nopatch

/norollback

/norestart

/?

Codici di errore per .NET Framework 3.0 Redistributable

Nella tabella seguente sono elencati i codici di errore che possono essere restituiti dal programma di installazione ridistribuibile di .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe o Dotnet3setup.exe). I codici di errore sono gli stessi per tutte le versioni del programma di installazione.

ERROR_SUCCESS

ERROR_INSTALL_USEREXIT

ERROR_INSTALL_FAILURE

ERROR_UNKNOWN_PRODUCT

ERROR_PATCH_PACKAGE_INVALID

ERROR_INVALID_COMMAND_LINE

ERROR_SUCCESS_REBOOT_INITIATED

ERROR_PATCH_PACKAGE_REJECTED

ERROR_SUCCESS_REBOOT_REQUIRED