WindowsServiceLifetime Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écoute le signal d’arrêt et suit l’état du service Windows.
public ref class WindowsServiceLifetime : System::ServiceProcess::ServiceBase, Microsoft::Extensions::Hosting::IHostLifetime[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetimepublic class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetime[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetimetype WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetimePublic Class WindowsServiceLifetime
Inherits ServiceBase
Implements IHostLifetime- Héritage
- Attributs
- Implémente
Constructeurs
| Nom | Description |
|---|---|
| WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>, IOptions<WindowsServiceLifetimeOptions>) |
Initialise une nouvelle instance de la classe WindowsServiceLifetime. |
| WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>) |
Initialise une nouvelle instance de WindowsServiceLifetime. |
Champs
| Nom | Description |
|---|---|
| MaxNameLength |
Indique la taille maximale d’un nom de service. (Hérité de ServiceBase) |
Propriétés
| Nom | Description |
|---|---|
| AutoLog |
Indique s’il faut signaler les commandes Démarrer, Arrêter, Suspendre et Continuer dans le journal des événements. (Hérité de ServiceBase) |
| CanHandlePowerEvent |
Obtient ou définit une valeur indiquant si le service peut gérer les notifications d’état de l’alimentation de l’ordinateur. (Hérité de ServiceBase) |
| CanHandleSessionChangeEvent |
Obtient ou définit une valeur qui indique si le service peut gérer les événements de modification de session reçus d’une session Terminal Server. (Hérité de ServiceBase) |
| CanPauseAndContinue |
Obtient ou définit une valeur indiquant si le service peut être suspendu et repris. (Hérité de ServiceBase) |
| CanShutdown |
Obtient ou définit une valeur indiquant si le service doit être averti lorsque le système s’arrête. (Hérité de ServiceBase) |
| CanStop |
Obtient ou définit une valeur indiquant si le service peut être arrêté une fois qu’il a démarré. (Hérité de ServiceBase) |
| EventLog |
Obtient un journal des événements que vous pouvez utiliser pour écrire la notification des appels de commande de service, tels que Start and Stop, dans le journal des événements de l’application. (Hérité de ServiceBase) |
| ExitCode |
Obtient ou définit le code de sortie du service. (Hérité de ServiceBase) |
| ServiceHandle |
Obtient le handle de contrôle de service pour le service. (Hérité de ServiceBase) |
| ServiceName |
Obtient ou définit le nom court utilisé pour identifier le service sur le système. (Hérité de ServiceBase) |
Méthodes
| Nom | Description |
|---|---|
| Dispose(Boolean) |
Libère les ressources utilisées par le WindowsServiceLifetime. |
| OnContinue() |
En cas d’implémentation dans une classe dérivée, OnContinue() s’exécute lorsqu’une commande Continuer est envoyée au service par le Gestionnaire de contrôle de service (SCM). Spécifie les actions à entreprendre lorsqu’un service reprend le fonctionnement normal après avoir été suspendu. (Hérité de ServiceBase) |
| OnCustomCommand(Int32) |
En cas d’implémentation dans une classe dérivée, OnCustomCommand(Int32) s’exécute lorsque le Gestionnaire de contrôle de service (SCM) transmet une commande personnalisée au service. Spécifie les actions à effectuer lorsqu’une commande avec la valeur de paramètre spécifiée se produit. (Hérité de ServiceBase) |
| OnPause() |
En cas d’implémentation dans une classe dérivée, s’exécute lorsqu’une commande Pause est envoyée au service par le Gestionnaire de contrôle de service (SCM). Spécifie les actions à effectuer lorsqu’un service s’interrompt. (Hérité de ServiceBase) |
| OnPowerEvent(PowerBroadcastStatus) |
En cas d’implémentation dans une classe dérivée, s’exécute lorsque l’état de l’alimentation de l’ordinateur a changé. Cela s’applique aux ordinateurs portables lorsqu’ils passent en mode suspendu, ce qui n’est pas le même qu’un arrêt du système. (Hérité de ServiceBase) |
| OnSessionChange(SessionChangeDescription) |
S’exécute lorsqu’un événement de modification est reçu d’une session Terminal Server. (Hérité de ServiceBase) |
| OnShutdown() |
S’exécute lorsqu’une commande d’arrêt est envoyée au service par le Gestionnaire de contrôle de service (SCM). |
| OnStart(String[]) |
En cas d’implémentation dans une classe dérivée, s’exécute lorsqu’une commande Start est envoyée au service par le Gestionnaire de contrôle de service (SCM) ou lorsque le système d’exploitation démarre (pour un service qui démarre automatiquement). Spécifie les actions à effectuer au démarrage du service. |
| OnStop() |
S’exécute lorsqu’une commande Stop est envoyée au service par le Gestionnaire de contrôle de service (SCM). |
| RequestAdditionalTime(Int32) |
Demande un délai supplémentaire pour une opération en attente. (Hérité de ServiceBase) |
| RequestAdditionalTime(TimeSpan) |
Lorsque cette méthode est appelée à partir de OnStart, OnStop, OnPause ou OnContinue, l’indicateur d’attente spécifié est transmis au Gestionnaire de contrôle de service pour éviter que le service ne réponde pas. (Hérité de ServiceBase) |
| ServiceMainCallback(Int32, IntPtr) |
Inscrit le gestionnaire de commandes et démarre le service. (Hérité de ServiceBase) |
| Stop() |
Arrête le service en cours d’exécution. (Hérité de ServiceBase) |
| StopAsync(CancellationToken) |
Arrête et arrête de façon asynchrone l’hôte. Cette méthode est appelée à partir de StopAsync(CancellationToken). |
| WaitForStartAsync(CancellationToken) |
Attend de façon asynchrone jusqu’à ce que le début soit terminé avant de continuer. Cette méthode est appelée au début de StartAsync(CancellationToken). Cela permet de retarder le démarrage jusqu'à ce que celui-ci soit signalé par un événement externe. |
