派生クラスに実装されると、Stop コマンドがサービス コントロール マネージャ (SCM) によってサービスに送信されるときに実行されます。サービスが実行を停止したときに実行されるアクションを指定します。
Protected Overridable Sub OnStop()
[C#]
protected virtual void OnStop();
[C++]
protected: virtual void OnStop();
[JScript]
protected function OnStop();
解説
OnStop を使用して、サービスが Stop コマンドを受信したときに発生する処理を指定します。
SCM では、Stop コマンドを受け取ると、 CanStop の値を使用して、サービスが Stop コマンドを受け入れるかどうかを確認します。 CanStop が true の場合、Stop コマンドはサービスに渡され、 OnStop メソッドが定義されている場合は呼び出されます。 OnStop がサービスに実装されていない場合は、SCM が Stop コマンドを処理します。
CanStop が false の場合、Stop コマンドは SCM で無視されます。Stop コマンドはサービスには渡されません。Stop コマンドは終了し、例外がスローされます。
OnStop は、派生クラスでオーバーライドされます。サービスを有効に使用するには、 OnStart と OnStop の両方をサービス クラスに実装する必要があります。
必要条件
プラットフォーム: 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 名前空間 | CanStop | OnContinue | OnPowerEvent | OnPause | OnShutdown | OnStart | OnCustomCommand