ServiceBase.CanPauseAndContinue Property

Definition

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Package:

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

Source:

ServiceBase.cs

Gets or sets a value indicating whether the service can be paused and resumed.

public:
 property bool CanPauseAndContinue { bool get(); void set(bool value); };

public bool CanPauseAndContinue { get; set; }

member this.CanPauseAndContinue : bool with get, set

Public Property CanPauseAndContinue As Boolean

Property Value

Boolean

true if the service can be paused; otherwise, false.

Exceptions

InvalidOperationException

The service has already been started. The CanPauseAndContinue property cannot be changed once the service has started.

Remarks

Set the value of the CanPauseAndContinue property in the constructor for the service.

When a service is paused, it halts what it is doing. When you continue the service (either through the Service Control Manager or programmatically), OnContinue runs.

Sending a Pause request to the service can conserve system resources. Pause may not release all system resources, but Stop does. OnPause and OnContinue are often implemented to perform less processing than OnStop and OnStart.

When CanPauseAndContinue is true, override OnPause and OnContinue to specify the processing that should occur when the Service Control Manager (SCM) passes a Pause or Continue request to your service. OnContinue should be implemented to undo the processing in OnPause.

If CanPauseAndContinue is false, the SCM will not pass Pause or Continue requests to the service, so the OnPause and OnContinue methods will not be called even if they are implemented. In the SCM, the Pause and Continue controls are disabled when CanPauseAndContinue is false.

See also

• OnPause()
• OnContinue()
• CanShutdown
• CanStop
• CanHandlePowerEvent