Comment : créer des services Windows

Article
09/11/2008

Mise à jour : novembre 2007

Lorsque vous créez un service, vous pouvez utiliser un modèle de projet Visual Studio appelé Service Windows. Ce modèle accomplit automatiquement pour vous une grande part du travail : il référence les classes et les espaces de noms requis, définit l'héritage à partir de la classe de base revenant aux services et substitue les méthodes que vous êtes le plus susceptible de vouloir substituer.

Remarque :
Le modèle Service Windows et les fonctionnalités associées ne sont pas disponibles dans la version standard de Visual Studio.

Pour créer un service fonctionnel, vous devez, au minimum :

Définissez la propriété ServiceName.
créer les programmes d'installation nécessaires à votre application de service ;
substituer et spécifier le code des méthodes OnStart et OnStop pour personnaliser le comportement de votre service.

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.

Pour créer une application de service Windows

Créez un projet Service Windows.

Remarque :

Pour savoir comment créer un service sans avoir recours au modèle, consultez Comment : écrire les services par programme.

Remarque :
Pour savoir comment créer un service sans avoir recours au modèle, consultez Comment : écrire les services par programme.

Dans la fenêtre Propriétés, définissez la propriété ServiceName pour votre service.

Remarque :
La valeur de la propriété ServiceName doit toujours correspondre au nom enregistré dans les classes Installer. Si vous modifiez cette propriété, vous devez également mettre à jour la propriété ServiceName des classes Installer.

Définissez le fonctionnement de votre service à l'aide des propriétés suivantes.

Propriété	Valeur
CanStop	True pour indiquer que le service acceptera des demandes d'arrêt ; false pour empêcher tout arrêt du service.
CanShutdown	True pour indiquer que le service doit recevoir une notification en cas d'arrêt de l'ordinateur sur lequel il s'exécute ; il peut ainsi appeler la procédure OnShutdown.
CanPauseAndContinue	True pour indiquer que le service acceptera des demandes de suspension et de redémarrage ; false pour empêcher une suspension et un redémarrage du service.
CanHandlePowerEvent	True pour indiquer que le service peut gérer la notification des modifications apportées à l'état d'alimentation de l'ordinateur ; false pour empêcher le service d'être averti de ces modifications.
AutoLog	True pour enregistrer des informations dans le journal des événements de l'application lorsque votre service effectue une action ; false pour désactiver cette fonctionnalité. Pour plus d'informations, consultez Comment : enregistrer des informations relatives aux services. Remarque : AutoLog a la valeur par défaut true.

Remarque :
Lorsque CanStopou CanPauseAndContinue a la valeur false, le Gestionnaire de contrôle des services désactive les éléments de menu correspondants pour arrêter, suspendre ou redémarrer le service.

Ouvrez l'éditeur de code et indiquez le traitement voulu pour les procédures OnStart et OnStop.
Substituez toutes les méthodes pour lesquelles vous voulez définir la fonctionnalité.
Ajoutez les programmes d'installation nécessaires à votre application de service. Pour plus d'informations, consultez Comment : ajouter des programmes d'installation à votre application de service.
Générez votre projet en sélectionnant Générer la solution dans le menu Générer.

Remarque :

N'appuyez pas sur la touche F5 pour exécuter le projet ; il n'est pas possible d'exécuter un projet de service de cette manière.
Installez le service. Pour plus d'informations, consultez Comment : installer et désinstaller des services.