ServiceController.Status Eigenschaft

Definition

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Paket:

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

Quelle:

ServiceController.cs

Ruft den Zustand des Diensts ab, auf den diese Instanz verweist.

public:
 property System::ServiceProcess::ServiceControllerStatus Status { System::ServiceProcess::ServiceControllerStatus get(); };

public System.ServiceProcess.ServiceControllerStatus Status { get; }

member this.Status : System.ServiceProcess.ServiceControllerStatus

Public ReadOnly Property Status As ServiceControllerStatus

Eigenschaftswert

ServiceControllerStatus

Einer der ServiceControllerStatus-Werte, mit dem angegeben wird, ob der Dienst ausgeführt wird, beendet wurde oder angehalten ist oder ob ein Befehl zum Starten, Beenden, Anhalten oder Fortsetzen aussteht.

Ausnahmen

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

InvalidOperationException

Der Dienst wurde nicht gefunden.

Beispiele

Im folgenden Beispiel wird die ServiceController -Klasse verwendet, um den aktuellen Status des Telnet-Diensts zu überprüfen. Wenn der Dienst beendet wird, startet das Beispiel den Dienst. Wenn der Dienst ausgeführt wird, beendet das Beispiel den Dienst.

// Toggle the Telnet service - 
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController^ sc = gcnew ServiceController(  "Telnet" );
if ( sc )
{
   Console::WriteLine(  "The Telnet service status is currently set to {0}", sc->Status );
   if ( (sc->Status == (ServiceControllerStatus::Stopped) ) || (sc->Status == (ServiceControllerStatus::StopPending) ) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Telnet service..." );
      sc->Start();
   }
   else
   {
      // Stop the service if its status is not set to "Stopped".
      Console::WriteLine(  "Stopping the Telnet service..." );
      sc->Stop();
   }

   // Refresh and display the current service status.
   sc->Refresh();
   Console::WriteLine(  "The Telnet service status is now set to {0}.", sc->Status );

// Toggle the Telnet service -
// If it is started (running, paused, etc), stop the service.
// If it is stopped, start the service.
ServiceController sc = new ServiceController("Telnet");
Console.WriteLine("The Telnet service status is currently set to {0}",
                  sc.Status);

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

   Console.WriteLine("Starting the Telnet service...");
   sc.Start();
}
else
{
   // Stop the service if its status is not set to "Stopped".

   Console.WriteLine("Stopping the Telnet service...");
   sc.Stop();
}

// Refresh and display the current service status.
sc.Refresh();
Console.WriteLine("The Telnet service status is now set to {0}.",
                   sc.Status);

' Toggle the Telnet service - 
' If it is started (running, paused, etc), stop the service.
' If it is stopped, start the service.
Dim sc As New ServiceController("Telnet")
Console.WriteLine("The Telnet service status is currently set to {0}", sc.Status)

If sc.Status.Equals(ServiceControllerStatus.Stopped) Or sc.Status.Equals(ServiceControllerStatus.StopPending) Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Telnet service...")
   sc.Start()
Else
   ' Stop the service if its status is not set to "Stopped".
   Console.WriteLine("Stopping the Telnet service...")
   sc.Stop()
End If

' Refresh and display the current service status.
sc.Refresh()
Console.WriteLine("The Telnet service status is now set to {0}.", sc.Status)

Hinweise

Der Status gibt den aktuellen Status des Diensts an. Der Satz möglicher Werte umfasst mehrere, die angeben, ob ein Zustandsänderungsbefehl aussteht.