Guide de déploiement de Microsoft .NET Framework 3.0

Article
05/11/2010

Microsoft Corporation

Juillet 2006

Contenu

Résumé
Introduction
Conditions requises pour l'installation
   Configuration logicielle
   Configuration matérielle
Où obtenir le package redistribuable .NET Framework 3.0
Redistribution de .NET Framework 3.0 à l’aide d’un projet d’installation de Visual Studio 2005
Des utilisateurs installent manuellement le .NET Framework
Chaînage du package redistribuable dans le programme d’installation de votre application
Redistribution de .NET Framework 3.0 pour les applications web
Détection de Microsoft .NET Framework 3.0
   Lecture des clés de Registre
   Lecture de la chaîne de l’agent utilisateur dans Internet Explorer
Options de ligne de commande pour .NET Framework 3.0 Redistributable
Codes d’erreur pour le .NET Framework 3.0 Redistribuable

Résumé

Cet article explique comment déployer des applications Microsoft .NET Framework 3.0 avec Dotnetfx3.exe, le package redistribuable .NET Framework 3.0. (10 pages imprimées)

Note Cette documentation peut inclure des informations sur les scénarios qui traitent de la distribution, mais la documentation ne vous accorde aucun droit d’utiliser ou de distribuer une partie des composants. Votre utilisation des composants est soumise au contrat de licence pour les composants. Consultez le contrat de licence composants pour comprendre vos droits et les conditions d’utilisation.

Introduction

Le Microsoft.NET Framework 3.0 fournit un programme d’installation redistribuable qui contient des liaisons .NET Framework 2.0 avec les API Windows Vista requises pour exécuter des applications .NET Framework 3.0.

Le package redistribuable .NET Framework 3.0 est disponible sous forme de fichier exécutable autonome. Le nom du fichier dépend du type de la plateforme ciblée. Pour les plateformes 32 bits, le fichier est nommé Dotnetfx3.exe. Pour les plateformes 64 bits, le fichier est nommé Dotnetfx3_x64.exe. Vous pouvez également déployer un petit package redistribuable nommé Dotnet3setup.exe qui télécharge les composants requis pendant l’installation.

Note La prise en charge d’IA64 dans .NET Framework 3.0 est limitée à Microsoft Windows Server nommé « Longhorn ». Longhorn inclut déjà .NET Framework 3.0, donc aucun package redistribuable n’est nécessaire.

Vous pouvez lancer et installer manuellement le redistribuable sur un ordinateur, ou il peut être lancé et installé dans le cadre du programme d’installation d’une application .NET Framework 3.0.

Note Des privilèges d’administrateur sont requis pour installer .NET Framework 3.0.

Conditions requises pour l'installation

Cette section décrit la configuration logicielle et matérielle requise pour un ordinateur sur lequel le package redistribuable Microsoft .NET Framework 3.0 doit être installé. Si la configuration minimale requise n’est pas remplie, Dotnetfx3.exe bloquera l’installation du package redistribuable.

Configuration logicielle

Pour installer Microsoft .NET Framework 3.0, l’un des systèmes d’exploitation suivants doit être installé sur l’ordinateur cible :

Microsoft Windows XP Famille ou Microsoft Windows XP Professionnel, tous deux avec Service Pack 2 ou version ultérieure.
Famille Microsoft Windows Server 2003 avec Service Pack 1 ou version ultérieure.

Pour Microsoft Windows Vista (sans la plateforme IA64) et Microsoft Windows Server au nom de code « Longhorn » IA64 Edition, .NET Framework 3.0 est une fonctionnalité du système d’exploitation.

Configuration matérielle

Le tableau suivant répertorie la configuration matérielle requise pour l’exécution de .NET Framework 3.0.

	Processeur requis	RAM requise
Minimum	Pentium 400 MHz	96 Mo
Recommandé	Pentium 1 GHz ou supérieur	256 Mo ou plus

Où obtenir le package redistribuable .NET Framework 3.0

Vous pouvez télécharger le package redistribuable Microsoft .NET Framework 3.0 à partir du Centre de téléchargement Microsoft Vista ou du site Web Microsoft Windows Update.

Note Le site Microsoft Windows Update offre uniquement la version officiellement publiée du .NET Framework 3.0 ; il n’offre pas de versions bêta.

Si les utilisateurs doivent installer Microsoft .NET Framework 3.0 à partir d’Internet, ne publiez pas le package redistribuable sur votre propre réseau. Au lieu de cela, dirigez les utilisateurs vers le Centre de téléchargement Microsoft Vista ou le site Web Microsoft Windows Update.

Redistribution de .NET Framework 3.0 à l’aide d’un projet d’installation de Visual Studio 2005

Lorsque vous déployez des applications créées avec Visual Studio 2005 et qui nécessitent .NET Framework 3.0, le .NET Framework doit être installé sur l’ordinateur cible avant d’installer votre application. Vous pouvez inclure .NET Framework 3.0 dans un fichier exécutable d’installation que vous créez à l’aide d’un projet d’installation Visual Studio 2005. Si cela n’est pas pratique, vous pouvez faire installer manuellement le .NET Framework, comme décrit plus loin.

Lorsque vous configurez un projet d’installation de Visual Studio 2005 pour installer Microsoft .NET Framework 3.0 avec votre application, .NET Framework 3.0 est empaqueté avec votre application. Une condition de lancement dans le programme d’installation de votre application vérifie whether.NET Framework 3.0 est installé et, si nécessaire, le processus d’installation installe le .NET Framework avant d’installer votre application. Microsoft .NET Framework 3.0 vérifie à son tour whether.NET Framework 2.0 est installé. Si ce n’est pas le cas, le processus d’installation invite également l’utilisateur à installer la version antérieure du .NET Framework.

Pour inclure .NET Framework 3.0 dans le processus d’installation de votre application, les extensions Visual Studio facultatives pour .NET Framework 3.0 doivent être installées sur l’ordinateur sur lequel vous créez le projet d’installation.

Pour déterminer si les extensions Visual Studio pour .NET Framework 3.0 sont installées

Dans le Panneau de configuration Windows, cliquez sur Ajouter ou supprimer des programmes.
Dans la boîte de dialogue Ajouter ou supprimer des programmes , examinez la liste Programmes actuellement installés pour les extensions Microsoft Visual Studio 2005 pour .NET Framework 3.0.

Si les extensions Visual Studio 2005 pour .NET Framework 3.0 ne sont pas répertoriées, vous pouvez télécharger et installer le package d’extensions dans le cadre des outils de développement pour WinFX, disponibles dans la page Microsoft Visual Studio Code Name « Orcas » Community Technology Preview – Outils de développement pour WinFX dans le Centre de téléchargement Microsoft.

Lorsque vous êtes sûr d’avoir installé le package Extensions Visual Studio pour .NET Framework 3.0 sur votre ordinateur, vous pouvez créer un projet d’installation qui inclut .NET Framework 3.0.

Pour inclure .NET Framework 3.0 avec un projet d’installation

Dans Visual Studio 2005, créez un projet d’installation en suivant ces étapes :
1. Dans le menu Fichier , cliquez sur Nouveau, puis sur Projet.
2. Sous Autres types de projets, sélectionnez Configuration et déploiement.
3. Nommez votre projet, puis cliquez sur OK.
Ajoutez votre sortie de projet, fusionnez des modules, un fichier et des assemblys.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Propriétés.

La boîte de dialogue Pages de propriétés s’affiche.
Cliquez sur Prérequis.
Sélectionnez la zone Créer un programme d’installation pour installer les composants requis case activée.
Dans la liste, recherchez Microsoft .NET Framework 3.0 , puis sélectionnez la version appropriée pour les plateformes cibles.
Spécifiez l’emplacement source pour les prérequis.

Pour l’emplacement du .NET Framework 3.0, vous pouvez spécifier le site de téléchargement Windows Vista ou votre propre site. L’URL peut également spécifier un CD sur lequel votre propre application est distribuée.
Cliquez sur OK.

Des utilisateurs installent manuellement le .NET Framework

Dans certains cas, il peut être difficile d’installer automatiquement .NET Framework 3.0 avec votre application. Dans ce cas, vous pouvez faire en sorte que les utilisateurs installent le .NET Framework eux-mêmes. Le redistributable est disponible à partir de plusieurs sources, comme indiqué plus haut dans la section Où obtenir the.NET Framework 3.0 Package redistribuable. Toutefois, vous ne devez pas supposer que les utilisateurs de votre application savent où l’obtenir ou comment l’installer. Dans votre processus d'installation, fournissez des instructions sur la manière dont les utilisateurs doivent chercher et installer le .NET Framework.

Chaînage du package redistribuable dans le programme d’installation de votre application

Si vous ne souhaitez pas créer de projet d’installation Visual Studio ou si les utilisateurs installent manuellement .NET Framework 3.0, vous pouvez chaîner le processus d’installation de .NET Framework 3.0 dans le cadre de votre propre configuration d’application. Pour chaîner le processus d’installation de .NET Framework 3.0, vous pouvez exécuter le redistribuable à partir de la ligne de commande et utiliser l’option de ligne de commande d’installation en mode silencieux suivante :

/q /norestart

Redistribution de .NET Framework 3.0 pour les applications web

Dans les applications web qui s’appuient sur les fonctionnalités de .NET Framework 3.0, il peut être nécessaire de télécharger et d’installer le .NET Framework sur l’ordinateur de l’utilisateur. Vous pouvez déterminer si .NET Framework 3.0 est installé sur l’ordinateur de l’utilisateur en interrogeant la chaîne de l’agent utilisateur dans l’en-tête du navigateur. Si la version correcte du .NET Framework n’est pas installée, vous pouvez diriger les utilisateurs vers le Centre de téléchargement .NET Framework 3.0 pour obtenir le package .NET Framework 3.0.

Détection de Microsoft .NET Framework 3.0

Vous pouvez détecter si le .NET Framework 3.0 est installé en lisant une clé de Registre et en interrogeant la chaîne de l’agent utilisateur dans Internet Explorer.

Lecture des clés de Registre

Le programme d’installation de .NET Framework 3.0 écrit des clés de Registre lorsque l’installation réussit. Vous pouvez tester whether.NET Framework 3.0 est installé en vérifiant les clés de Registre répertoriées dans le tableau suivant.

Nom de la clé du Registre Valeur

Nom de la clé du Registre	Valeur
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup`	Nom : `InstallSuccess` Type : DWORD Données : `1`
`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\User Agent\Post Platform`	Nom : `Version` Type: REG_SZ Données : `.NET CLR 3.0.build number`

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

Nom : InstallSuccess

Type : DWORD

Données : 1

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

Nom : Version

Type: REG_SZ

Données : .NET CLR 3.0.build number

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

Lorsque .NET Framework 3.0 est installé sur un ordinateur, le numéro de version de .NET Framework 3.0 s’affiche dans la chaîne de l’agent utilisateur signalée dans les en-têtes de navigateur. L’exemple suivant montre un exemple de page qui utilise JavaScript pour détecter et signaler whether.NET Framework 3.0 est installé.

Note Cet exemple de page nécessite des Explorer Internet.

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

Si la recherche de la version de chaîne .NET Framework 3.0 » réussit, le message suivant s’affiche :

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

Sinon, le message suivant s’affiche :

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

Options de ligne de commande pour .NET Framework 3.0 Redistributable

Le tableau suivant répertorie les options que vous pouvez inclure lorsque vous exécutez le programme d’installation redistribuable .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe ou Dotnet3setup.exe) à partir de la ligne de commande.

Option	Description
`/q`	Supprime toute l’interface utilisateur. Impossible de spécifier un fichier .INI avec cette option.
`/quiet`	Comme pour `/q`.
`/qb`	Affiche l’interface utilisateur minimale, affichant uniquement la progression.
`/passive`	Comme pour `/qb`.
`/uninstall`	Désinstalle le produit.
`/remove`	Comme pour `/uninstall`.
`/f`	Répare tous les composants .NET Framework 3.0 installés.
`/nopatch`	Spécifie que les correctifs ne sont pas appliqués et contourne la vérification corrective.
`/norollback`	Spécifie que le programme d’installation n’est pas restauré en cas d’échec d’un composant d’installation.
`/norestart`	Spécifie que le programme d’installation ne redémarre pas l’ordinateur une fois l’installation terminée. Le programme d’installation redistribuable retourne ERROR_SUCCESS_REBOOT_REQUIRED (3010) si un redémarrage est nécessaire.
`/?`	Affiche cette liste d’options.

Codes d’erreur pour le .NET Framework 3.0 Redistribuable

Le tableau suivant répertorie les codes d’erreur qui peuvent être retournés par le programme d’installation redistribuable .NET Framework 3.0 (Dotnetfx3.exe, Dotnetfx3_x64.exe ou Dotnet3setup.exe). Les codes d’erreur sont les mêmes pour toutes les versions du programme d’installation.

Code d'erreur	Valeur	Description
`ERROR_SUCCESS`	0	L’action s’est terminée avec succès.
`ERROR_INSTALL_USEREXIT`	1602	L’installation de l’utilisateur a été annulée.
`ERROR_INSTALL_FAILURE`	1603	Une erreur irrécupérable s’est produite pendant l’installation.
`ERROR_UNKNOWN_PRODUCT`	1605	Cette action est valide uniquement pour les produits actuellement installés.
`ERROR_PATCH_PACKAGE_INVALID`	1636	Le package de correctifs n’a pas pu être ouvert ou le correctif n’était pas applicable à .NET Framework 3.0.
`ERROR_INVALID_COMMAND_LINE`	1639	Argument de ligne de commande non valide.
`ERROR_SUCCESS_REBOOT_INITIATED`	1641	Le programme d’installation a lancé un redémarrage. Cela indique la réussite et l’installation se poursuit après le redémarrage. (Le redémarrage n’est pas effectué si l’option `/norestart` a été spécifiée.)
`ERROR_PATCH_PACKAGE_REJECTED`	1643	Le package de correctifs n’est pas autorisé par la stratégie système.
`ERROR_SUCCESS_REBOOT_REQUIRED`	3010	Un redémarrage est nécessaire pour terminer l'installation. Ce message indique que l'opération a réussi.