ServiceBase.CanPauseAndContinue プロパティ

.NET Framework クラス ライブラリ リファレンス

ServiceBase.CanPauseAndContinue プロパティ

サービスを一時中断および再開できるかどうかを示す値を取得または設定します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Property CanPauseAndContinue As
 Boolean

Visual Basic (使用法)

Dim instance As ServiceBase
Dim value As Boolean

value = instance.CanPauseAndContinue

instance.CanPauseAndContinue = value

C#

public bool CanPauseAndContinue { get;
 set; }

C++

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

J#

/** @property */
public boolean get_CanPauseAndContinue ()

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

JScript

public function get CanPauseAndContinue
 () : boolean

public function set CanPauseAndContinue
 (value : boolean)

プロパティ値
サービスを一時中断できる場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	サービスが既に開始されています。CanPauseAndContinue プロパティは、サービスが開始された後は変更できません。

解説

サービスが一時中断されると、サービスが実行している動作も中断されます。サービス コントロール マネージャを使用して、またはプログラムによってサービスを継続すると、OnContinue が実行されます。

Pause 要求をサービスに送信すると、システム リソースを保持できます。Pause はすべてのシステム リソースを解放しませんが、Stop はすべてのシステム リソースを解放します。OnPause と OnContinue は、多くの場合 OnStop と OnStart よりも少ない処理を実行するために実装されます。

CanPauseAndContinue が true の場合は、OnPause および OnContinue をオーバーライドして、サービス コントロール マネージャ (SCM) が Pause 要求または Continue 要求をサービスに渡すときに発生する処理を指定します。OnPause の処理を元に戻すには、OnContinue を実装する必要があります。

CanPauseAndContinue が false の場合、SCM は Pause 要求または Continue 要求をサービスに渡さないため、OnPause メソッドと OnContinue メソッドは、実装されている場合でも呼び出されません。SCM では、CanPauseAndContinue が false に設定されていると、Pause コントロールと Continue コントロールが無効になります。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceBase クラス
ServiceBase メンバ
System.ServiceProcess 名前空間
OnPause
OnContinue
CanShutdown
CanStop
ServiceBase.CanHandlePowerEvent プロパティ