Comment : ajouter des programmes d'installation à votre application de service
Mise à jour : novembre 2007
Visual Studio vous est fourni avec des composants qui vous permettent d'installer les ressources associées à vos applications de service. Les composants d'installation inscrivent chaque service dans le système sur lequel il doit être installé et avertissent le Gestionnaire de contrôle des services de son existence. Lorsque vous travaillez avec une application de service, vous pouvez sélectionner un lien dans la fenêtre Propriétés pour automatiquement ajouter les programmes d'installation à votre projet. Pour plus d'informations sur les composants d'installation et leur fonctionnement, consultez Introduction aux composants d'installation.
.gif "Remarque") Remarque : |
|---|
Les valeurs de propriété de votre service sont copiées de la classe de service dans la classe Installer. Si vous mettez à jour la valeur de certaines propriétés dans la classe de service, la modification n'est pas automatiquement répercutée dans le programme d'installation. |
Lorsque vous ajoutez un programme d'installation à votre projet, une nouvelle classe (appelée par défaut ProjectInstaller) est constituée dans le projet, et des instances des composants d'installation requis sont créées dans cette classe. Cette classe centralise tous les composants d'installation nécessaires à votre projet. Par exemple, si vous ajoutez un deuxième service à votre application, une deuxième classe Installer n'est pas créée lorsque vous cliquez sur le lien Ajouter le programme d'installation ; en revanche, le composant d'installation supplémentaire requis pour ce second service est ajouté à la classe existante.
Vous n'avez pas besoin d'écrire un code spécial dans les programmes d'installation pour que vos services s'installent correctement. Toutefois, vous pouvez parfois avoir besoin de modifier le contenu des programmes d'installation pour ajouter certaines fonctionnalités au processus d'installation. Pour plus d'informations, consultez Comment : configurer des composants d'installation.
Une fois les programmes d'installation ajoutés à l'application, la prochaine étape consiste à créer un projet d'installation qui va installer les fichiers projets compilés et exécuter les programmes d'installation requis pour installer votre service. Pour créer un projet d'installation complet, vous devez ajouter la sortie du projet de service au projet d'installation, puis une action personnalisée afin d'installer le service. Pour plus d'informations sur les projets d'installation, consultez Projets d'installation. Pour plus d'informations sur les actions personnalisées, consultez Procédure pas à pas : création d'une action personnalisée.
| Remarque : |
|---|
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio. |
Pour ajouter des programmes d'installation à votre application de service
Dans l'Explorateur de solutions, activez le mode Design pour le service pour lequel vous voulez ajouter un composant d'installation.
Cliquez sur l'arrière-plan du concepteur pour sélectionner le service lui-même plutôt que son contenu.
Avec le concepteur dans le focus, cliquez avec le bouton droit, puis cliquez sur Ajouter le programme d'installation.
Une nouvelle classe, ProjectInstaller, et deux composants d'installation, ServiceProcessInstaller et ServiceInstaller, sont ajoutés à votre projet, et les valeurs de propriété du service sont copiées dans ces composants.
Cliquez sur le composant ServiceInstaller et vérifiez que la valeur de la propriété ServiceName est identique à celle de la propriété ServiceName du service.
Pour connaître le mode de démarrage du service, cliquez sur le composant ServiceInstaller et attribuez à la propriété StartType la valeur appropriée.
Valeur
Résultat
Le service doit être démarré manuellement après installation. Pour plus d'informations, consultez Comment : démarrer des services.
Le service démarre automatiquement à chaque redémarrage de l'ordinateur.
Le service ne peut pas être démarré.
Pour déterminer le contexte de sécurité dans lequel s'exécute le service, cliquez sur le composant ServiceProcessInstaller et attribuez aux propriétés les valeurs appropriées. Pour plus d'informations, consultez Comment : spécifier le contexte de sécurité des services.
Substituez les méthodes pour lesquelles vous devez effectuer un traitement personnalisé. Pour plus d'informations, consultez Comment : substituer les méthodes par défaut des composants d'installation.
Exécutez les étapes 1 à 7 pour chaque service supplémentaire de votre projet.
Remarque :Pour chaque service supplémentaire de votre projet, vous devez ajouter un autre composant ServiceInstaller à la classe ProjectInstaller du projet. Le composant ServiceProcessInstaller ajouté à l'étape 3 fonctionne avec tous les programmes d'installation de service du projet.
Créez un projet d'installation et une action personnalisée pour déployer et installer votre service. Pour plus d'informations sur les projets d'installation, consultez Projets d'installation. Pour plus d'informations sur les actions personnalisées, consultez Procédure pas à pas : création d'une action personnalisée.
Voir aussi
Tâches
Comment : installer et désinstaller des services
Comment : démarrer des services
Comment : spécifier le contexte de sécurité des services
Comment : configurer des composants d'installation
Comment : substituer les méthodes par défaut des composants d'installation