サービスを開始した後に停止できるかどうかを示す値を取得または設定します。
Public Property CanStop As Boolean
[C#]
public bool CanStop {get; set;}
[C++]
public: __property bool get_CanStop();public: __property void set_CanStop(bool);
[JScript]
public function get CanStop() : Boolean;public function set CanStop(Boolean);
プロパティ値
サービスを停止でき、 OnStop メソッドを呼び出すことができる場合は true 。それ以外の場合は false 。
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | サービスが既に開始されています。 CanStop プロパティは、サービスが開始された後は変更できません。 |
解説
サービスで Stop が呼び出されると、サービス コントロール マネージャ (SCM) は、 CanStop の値を使用して、サービスが Stop コマンドを受け入れるかどうかを確認します。ほとんどのサービスでは、 CanStop の値は true ですが、オペレーティング システムのサービスによっては、ユーザーがサービスの停止などを行うことができない場合があります。
CanStop が true の場合、Stop コマンドはサービスに渡され、 OnStop メソッドが定義されている場合は呼び出されます。 OnStop が派生クラスに実装されていない場合、SCM は、空の基本クラス ServiceBase.OnStop メソッドを経由して Stop コマンドを処理します。
必要条件
プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
ServiceBase クラス | ServiceBase メンバ | System.ServiceProcess 名前空間 | OnStop | CanPauseAndContinue | CanShutdown | CanHandlePowerEvent