ServiceController.CanStop Property

Definition

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Package:

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

Gets a value indicating whether the service can be stopped after it has started.

public:
 property bool CanStop { bool get(); };

public bool CanStop { get; }

member this.CanStop : bool

Public ReadOnly Property CanStop As Boolean

Property Value

Boolean

true if the service can be stopped and the OnStop() method called; otherwise, false.

Exceptions

Win32Exception

An error occurred when accessing a system API.

InvalidOperationException

The service was not found.

Examples

The following example demonstrates the use of the CanStop property to determine whether a service provides a handler for a stop event. This example is part of a larger example that is provided for the ServiceController class.

// Display properties for the Simple Service sample
// from the ServiceBase example.
ServiceController sc = new ServiceController("Simple Service");
Console.WriteLine("Status = " + sc.Status);
Console.WriteLine("Can Pause and Continue = " + sc.CanPauseAndContinue);
Console.WriteLine("Can ShutDown = " + sc.CanShutdown);
Console.WriteLine("Can Stop = " + sc.CanStop);

' Display properties for the Simple Service sample 
' from the ServiceBase example
Dim sc As New ServiceController("Simple Service")
Console.WriteLine("Status = " + sc.Status.ToString())
Console.WriteLine("Can Pause and Continue = " + _
    sc.CanPauseAndContinue.ToString())
Console.WriteLine("Can ShutDown = " + sc.CanShutdown.ToString())
Console.WriteLine("Can Stop = " + sc.CanStop.ToString())