ServiceController.WaitForStatus Méthode

Définition

Espace de noms:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Paquet:

System.ServiceProcess.ServiceController v9.0.0-rc.1.24431.7

Attend que le service atteigne l'état spécifié.

Surcharges

WaitForStatus(ServiceControllerStatus)	Attend indéfiniment que le service atteigne l'état spécifié.
WaitForStatus(ServiceControllerStatus, TimeSpan)	Attend que le service atteigne l'état spécifié ou l'expiration du délai d'attente spécifié.

WaitForStatus(ServiceControllerStatus)

Source:

ServiceController.cs

Attend indéfiniment que le service atteigne l'état spécifié.

C#

public void WaitForStatus (System.ServiceProcess.ServiceControllerStatus desiredStatus);

Paramètres

desiredStatus

ServiceControllerStatus

État qu'il faut attendre.

Exceptions

InvalidEnumArgumentException

Le paramètre desiredStatus ne représente aucune des valeurs définies dans l'énumération ServiceControllerStatus.

Exemples

L’exemple suivant utilise la ServiceController classe pour vérifier si le service Alerter est arrêté. Si le service est arrêté, l’exemple démarre le service et attend que l’état du service soit défini sur Running.

C#

// Check whether the Alerter service is started.

ServiceController sc  = new ServiceController();
sc.ServiceName = "Alerter";
Console.WriteLine("The Alerter service status is currently set to {0}",
                   sc.Status);

if (sc.Status == ServiceControllerStatus.Stopped)
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Alerter service...");
   try
   {
      // Start the service, and wait until its status is "Running".
      sc.Start();
      sc.WaitForStatus(ServiceControllerStatus.Running);

      // Display the current service status.
      Console.WriteLine("The Alerter service status is now set to {0}.",
                         sc.Status);
   }
   catch (InvalidOperationException)
   {
      Console.WriteLine("Could not start the Alerter service.");
   }
}

Remarques

Permet WaitForStatus de suspendre le traitement d’une application jusqu’à ce que le service ait atteint l’état requis.

Note

La WaitForStatus méthode attend environ 250 millisecondes entre chaque vérification d’état. WaitForStatus ne peut pas détecter le cas où le service observé passe à l’état desiredStatus , puis immédiatement à un autre état dans cet intervalle.

Voir aussi

• Status

WaitForStatus(ServiceControllerStatus, TimeSpan)

Source:

ServiceController.cs

Attend que le service atteigne l'état spécifié ou l'expiration du délai d'attente spécifié.

C#

public void WaitForStatus (System.ServiceProcess.ServiceControllerStatus desiredStatus, TimeSpan timeout);

Paramètres

desiredStatus

ServiceControllerStatus

État qu'il faut attendre.

timeout

TimeSpan

Objet TimeSpan spécifiant le temps d'attente avant que le service n'atteigne l'état spécifié.

Exceptions

InvalidEnumArgumentException

Le paramètre desiredStatus ne représente aucune des valeurs définies dans l'énumération ServiceControllerStatus.

TimeoutException

Valeur spécifiée pour l'expiration du paramètre timeout.

Remarques

Permet WaitForStatus de suspendre le traitement d’une application jusqu’à ce que le service ait atteint l’état requis.

Note

La WaitForStatus méthode attend environ 250 millisecondes entre chaque vérification d’état. WaitForStatus ne peut pas détecter le cas où le service observé passe à l’état desiredStatus , puis immédiatement à un autre état dans cet intervalle.

Voir aussi

• Status