ServiceBase.CanPauseAndContinue Property

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

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

public bool CanPauseAndContinue { get; set; }
/** @property */
public boolean get_CanPauseAndContinue ()

/** @property */
public void set_CanPauseAndContinue (boolean value)

public function get CanPauseAndContinue () : boolean

public function set CanPauseAndContinue (value : boolean)

Not applicable.

Property Value

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

Exception typeCondition

InvalidOperationException

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

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.

The following example shows the setting of the CanPauseAndContinue property for a service class derived from ServiceBase. This code example is part of a larger example provided for the ServiceBase class.

public SimpleService()
{
    CanPauseAndContinue = true;
    CanHandleSessionChangeEvent = true;
    ServiceName = "SimpleService";
}

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: