Procédure : ajouter des programmes d’installation à votre application de service

  • Article

Remarque

Cet article ne s’applique pas aux services hébergés dans .NET. Afin d’obtenir le tout dernier contenu pour les services Windows qui utilisent Microsoft.Extensions.Hosting.BackgroundService et le modèle de service Worker, consultez :

Visual Studio est fourni avec des composants d’installation qui peuvent installer des ressources associées à vos applications de service. Les composants d’installation inscrivent un service auprès du système sur lequel il est installé et informent le Gestionnaire de contrôle des services de l’existence du service. Quand vous travaillez avec une application de service, vous pouvez sélectionner un lien dans la fenêtre Propriétés pour ajouter automatiquement les programmes d’installation appropriés à votre projet.

Notes

Les valeurs des propriétés de votre service sont copiées de la classe de service dans la classe du programme d’installation. Si vous modifiez les valeurs des propriétés sur la classe de service, vos modifications ne sont pas automatiquement répercutées dans le programme d’installation.

Quand vous ajoutez un programme d’installation à votre projet, une nouvelle classe (nommée par défaut ProjectInstaller) est créée dans le projet, et des instances des composants d’installation appropriés sont créées dans celui-ci. Cette classe sert de point central à tous les composants d’installation dont votre projet a besoin. Par exemple, le fait d’ajouter un deuxième service à votre application et de cliquer sur le lien Ajouter le programme d’installation n’entraîne pas l’ajout d’une deuxième classe dans le programme d’installation. Au lieu de cela, le composant d’installation nécessaire pour le deuxième service est ajouté à la classe existante.

Les programmes d’installation ne nécessitent aucun codage spécial pour que vos services s’installent correctement. Toutefois, vous devrez parfois modifier le contenu des programmes d’installation pour ajouter des fonctionnalités spéciales au processus d’installation.

Notes

Les boîtes de dialogue et les commandes de menu affichées peuvent différer de celles décrites dans l'Aide selon les paramètres actifs ou le mode d'édition. Pour modifier vos paramètres, choisissez Paramètres d'importation et d'exportation dans le menu Outils . Pour plus d’informations, consultez Personnaliser l’IDE Visual Studio.

Pour ajouter des programmes d’installation à votre application de service

  1. Dans l’Explorateur de solutions, accédez au mode Création du service auquel vous souhaitez ajouter un composant d’installation.

  2. Cliquez sur l’arrière-plan du concepteur pour sélectionner le service lui-même et non son contenu.

  3. Lorsque le concepteur a 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 des propriétés du service sont copiées dans les composants.

  4. Cliquez sur le composant ServiceInstaller et vérifiez que la valeur de la propriété ServiceName est identique à celle de la propriété ServiceName sur le service.

  5. Pour déterminer le mode de démarrage de votre service, cliquez sur le composant ServiceInstaller et définissez la propriété StartType avec la valeur appropriée.

    Valeur Résultats
    Manual Vous devez démarrer manuellement le service après l’installation. Pour plus d’informations, consultez Guide pratique pour démarrer des services.
    Automatic Le service démarre automatiquement à chaque redémarrage de l’ordinateur.
    Disabled Le service ne peut pas être démarré.

  6. Pour déterminer le contexte de sécurité dans lequel votre service va s’exécuter, cliquez sur le composant ServiceProcessInstaller et définissez les valeurs de propriété appropriées. Pour plus d’informations, consultez Guide pratique pour spécifier le contexte de sécurité des services.

  7. Substituez les méthodes qui doivent faire l’objet d’un traitement personnalisé.

  8. Effectuez les étapes 1 à 7 pour chaque service supplémentaire dans votre projet.

    Notes

    Pour chaque service supplémentaire dans votre projet, ajoutez un composant ServiceInstaller à la classe ProjectInstaller du projet. Le composant ServiceProcessInstaller ajouté à la troisième étape fonctionne avec tous les programmes d’installation de service dans le projet.

Voir aussi