Guide de déploiement de .NET Framework 3.5 pour les développeurs d'applications

Le .NET Framework version 3.5 fournit un programme d'installation redistribuable qui contient également le Service Pack et les mises à jour cumulatives pour le .NET Framework versions 2.0 et 3.0.

Cette rubrique explique comment redistribuer le .NET Framework avec vos applications. Elle contient les sections suivantes :

• Formats disponibles

• Où se procurer le package redistribuable .NET Framework 3.5 ?

• Conditions requises pour l'installation

• Installation manuelle du .NET Framework

• Chaînage du package redistribuable dans le programme d'installation de l'application

• Installation de .NET Framework 3.5 pour les applications Web

• Détection de .NET Framework 3.5

• Options de ligne de commande

• Codes d'erreur.

• Annexe : Composants .NET Framework 3.5

• Annexe : Exemples d'installation

Formats disponibles

Le package redistribuable .NET Framework 3.5 est disponible sous deux formes :

• dotnetfx35.exe  Fichier exécutable autonome qui contient tous les composants requis pour un déploiement sur des plateformes 32 bits et 64 bits pour tous les systèmes d'exploitation pris en charge. Ce fichier exécutable ne contient pas de module linguistique ; par défaut, il télécharge et installe le module linguistique qui correspond à la langue du système d'exploitation de l'utilisateur. Les modules linguistiques du .NET Framework version 3.5 sont disponibles sous forme de fichiers exécutables autonomes, distincts pour chaque langue, sur le site Web du Centre de téléchargement Microsoft.

• dotnetfx35setup.exe  Programme d'amorçage léger qui télécharge les composants requis à partir d'Internet pendant l'installation. Ce fichier exécutable ne contient pas de composant .NET Framework version 3.5 ; il détecte, télécharge et installe uniquement les composants requis à partir d'Internet. Le programme d'amorçage télécharge et installe également le module linguistique qui correspond à la langue du système d'exploitation de l'utilisateur. Les modules linguistiques autonomes peuvent être utilisés pour installer la prise en charge de langues supplémentaires.

Vous pouvez utiliser l'un ou l'autre des packages sur les plateformes 32 bits et 64 bits pour tous les systèmes d'exploitation pris en charge.

Le lancement et l'installation du package redistribuable sur un ordinateur peuvent être manuels ou intégrés au programme d'installation d'une application .NET Framework 3.5.

Remarque :
Les privilèges d'administrateur sont requis pour installer .NET Framework 3.5.

Où se procurer le package redistribuable .NET Framework 3.5 ?

Vous pouvez télécharger le package redistribuable Microsoft .NET Framework 3.5 à partir du Centre de téléchargement Microsoft. Le bouton Télécharger en haut de la page permet d'installer le programme d'amorçage (dotNetFx35setup.exe). Pour télécharger l'intégralité du package d'installation, faites défiler jusqu'au lien Package redistribuable complet, situé au bas de la page.

Conditions requises pour l'installation

Cette section récapitule la configuration logicielle et matérielle requise pour l'installation de .NET Framework 3.5. Si la configuration minimale requise n'est pas respectée, le processus d'installation du .NET Framework s'arrête.

Pour obtenir une liste détaillée de la configuration logicielle et matérielle requise, consultez .Configuration requise pour la version 3,5.

Configuration logicielle requise

.NET Framework 3.5 requiert l'un des systèmes d'exploitation suivants sur l'ordinateur cible :

• Windows XP Édition Familiale ou Windows XP Professionnel, avec Service Pack 2 ou version ultérieure.

• Famille Windows Server 2003 avec Service Pack 1 ou version ultérieure.

• Windows Vista.

• Windows Server 2008.

  Remarque :
  .NET Framework 3.5 prend en charge IA64 uniquement sur Microsoft Windows Server 2008.

Configuration matérielle requise

Le tableau suivant présente la configuration requise en termes de processeur et de mémoire RAM pour l'exécution de .NET Framework 3.5.

Installation manuelle du .NET Framework

Il peut parfois se révéler peu pratique d'installer automatiquement .NET Framework 3.5 avec votre application. Dans ce cas, vous pouvez faire en sorte que les utilisateurs installent le .NET Framework eux-mêmes à partir du Centre de téléchargement Microsoft. Dans votre processus d'installation, fournissez des instructions aux utilisateurs pour la recherche et l'installation du .NET Framework.

Remarque :
Ne publiez pas le package redistribuable sur votre propre réseau. Dirigez plutôt les utilisateurs vers le Centre de téléchargement Microsoft.

Chaînage du package redistribuable dans le programme d'installation de l'application

La version .NET Framework 3.5 offre trois moyens d'inclure (de « chaîner ») le processus d'installation du .NET Framework dans le processus d'installation de votre application :

• Option 1. Laissez le processus d'installation du .NET Framework identifier les composants requis, puis les télécharger et les installer à partir d'Internet

  Pour permettre au processus d'installation du .NET Framework de détecter, de télécharger et d'installer uniquement les composants requis, utilisez le package dotnetfx35setup.exe. Pour chaîner le processus d'installation du .NET Framework, ajoutez la commande suivante au processus d'installation de votre application :

  dotnetfx35setup.exe /q /norestart

• Option 2. Incluez l'ensemble complet des fichiers .NET Framework sur votre média de redistribution afin que les utilisateurs n'aient pas à télécharger de fichiers supplémentaires à partir d'Internet pendant l'installation.

  Si vous souhaitez inclure tous les composants du processus d'installation du .NET Framework, utilisez le fichier exécutable autonome complet (dotnetfx35.exe). Ce package inclut les composants requis pour installer .NET Framework 3.5 sur les ordinateurs x86, x64 et IA64 sur tous les systèmes d'exploitation pris en charge. Utilisez ce package si l'espace de stockage et la durée de téléchargement ne posent pas de problème pour le déploiement de votre application. Pour chaîner le processus d'installation du .NET Framework, utilisez la commande suivante :

  dotnetfx35.exe /q /norestart

• Option 3. Incluez les composants les plus souvent requis pour vos utilisateurs et laissez le processus d'installation du .NET Framework détecter les composants manquants et les télécharger à partir d'Internet. Ce scénario est le mieux adapté si vous disposez d'une configuration de plateforme, de système d'exploitation ou de système utilisateur spécifique vers laquelle vous déployez votre application.

  Pour effectuer cette installation, vous devez d'abord récupérer le fichier exécutable autonome complet et extraire les fichiers à l'aide de la commande suivante :

  dotnetfx35.exe /x extract-location

  Après avoir extrait les fichiers, vous obtenez une structure de dossiers et de fichiers avec la liste des fichiers pour chaque composant de .NET Framework 3.5, comme présenté dans l' Annexe de ce document.

  Pour déployer .NET Framework 3.5, intégrez les composants appropriés à la structure de dossier créée par le processus d'extraction et chaînez-les dans l'installation du programme d'amorçage du .NET Framework à l'aide de la commande suivante :

  dotnetfx35setup.exe /q /norestart

  L'Annexe de ce document présente deux exemples d'éléments à inclure dans votre disposition.

Quel que soit le mode choisi, exécutez le package redistribuable à partir de la ligne de commande et utilisez les options de ligne de commande /q et /norestart pour chaîner le processus d'installation de .NET Framework 3.5.

Remarque :
Pour éviter que les modules linguistiques ne soient automatiquement téléchargés et installés, utilisez l'option de ligne de commande /lang:enu.

Installation de .NET Framework 3.5 pour les applications Web

Les applications Web qui utilisent les fonctionnalités de .NET Framework 3.5 peuvent nécessiter le téléchargement et l'installation du .NET Framework sur l'ordinateur de l'utilisateur. Vous pouvez déterminer si le .NET Framework 3.5 est installé sur l'ordinateur de l'utilisateur en suivant les instructions de la section suivante. Si la version appropriée du .NET Framework n'est pas installée, vous pouvez diriger les utilisateurs vers le Centre de téléchargement Microsoft pour qu'ils se procurent le package .NET Framework 3.5.

Détection de .NET Framework 3.5

Pour détecter si .NET Framework 3.5 est déjà installé, vous pouvez lire une clé de Registre ou interroger la chaîne de l'agent utilisateur dans Internet Explorer.

Lecture des clés de Registre

Le programme d'installation de .NET Framework 3.5 écrit des clés de Registre lorsque l'installation s'est déroulée correctement. Pour tester si .NET Framework 3.5 est installé, vérifiez les clés de Registre répertoriées dans le tableau suivant.

Lecture de la chaîne de l'agent utilisateur dans Internet Explorer

Lorsque .NET Framework 3.5 est installé sur un ordinateur, son numéro de version fait partie de la chaîne de l'agent utilisateur présente dans les en-têtes de navigateur. L'exemple suivant affiche une page qui utilise JavaScript pour détecter et signaler l'installation de .NET Framework 3.5.

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

Si la recherche de la version de la chaîne « .NET Framework 3.5 » est fructueuse, le message suivant s'affiche :

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).

(Les détails de la chaîne de l'agent utilisateur varient légèrement selon le navigateur et la version de navigateur utilisés pour rechercher le .NET Framework.)

Si .NET Framework 3.5 n'est pas installé, le message suivant s'affiche :

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

Options de ligne de commande

Le tableau suivant répertorie les options que vous pouvez spécifier lorsque vous exécutez le programme d'installation redistribuable de .NET Framework 3.5 à partir de la ligne de commande.

Codes d'erreur

Le tableau suivant répertorie les codes d'erreur qui peuvent être retournés par le programme d'installation redistribuable de .NET Framework 3.5. Les codes d'erreur sont identiques pour toutes les versions du programme d'installation.

Annexe

Dans les tableaux fournis dans cette annexe, les systèmes d'exploitation ont été abrégés comme suit :

• XP = Windows XP

• Vista = Windows Vista

• W2K3 = Windows Server 2003

• W2K8 = Windows Server 2008

Composants .NET Framework 3.5

Le tableau suivant répertorie les composants du .NET Framework version 3.5.

Exemples d'installation

Les exemples suivants répertorient les fichiers que vous devez inclure dans vos médias d'installation pour deux scénarios d'installation différents.

Remarque :
Lorsque vous incluez des composants individuels, vous devez les placer au même chemin d'accès relatif que le programme d'amorçage d'installation (dotNetFx35setup.exe) de .NET Framework 3.5.

Exemple 1

Le tableau suivant répertorie les fichiers que vous devez inclure dans la disposition de votre média d'installation si vous déployez vers Windows XP ou Windows Vista. La liste de fichiers suppose que les utilisateurs installent uniquement la version x86 et qu'ils ont déjà installé .NET Framework 2.0 SP1 et 3.0 SP1 (sur Windows XP et Windows Server 2003) ou la mise à jour cumulative (sur Windows Vista).

Exemple 2

Le tableau suivant répertorie les fichiers que vous devez inclure dans la disposition de votre média d'installation si vous déployez vers Windows XP SP2 ou Windows Server 2003 SP1 sur des ordinateurs x86 et x64. La liste de fichiers suppose que les utilisateurs ont déjà installé .NET Framework version 2.0 SP1.

Remarque :
dans cet exemple, si l'utilisateur ne dispose pas de .NET Framework 2.0 SP1, le programme d'installation le téléchargera automatiquement si l'utilisateur est connecté à Internet.

Voir aussi

Concepts

Guide de déploiement de .NET Framework 3.5 pour les administrateurs