ServiceBase.OnStop 方法
本文內容
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在衍生類別中實作時,當服務控制管理員 (SCM) 傳送停止命令至服務時執行。 指定在服務停止執行時所要執行的動作。
protected:
virtual void OnStop();
protected virtual void OnStop();
abstract member OnStop : unit -> unit
override this.OnStop : unit -> unit
Protected Overridable Sub OnStop ()
使用 OnStop 來指定服務收到 Stop 命令時所發生的處理。
當 SCM 收到 Stop 命令時,它會使用 的值 CanStop 來驗證服務是否接受 Stop 命令。 如果 為 CanStoptrue
,則會將 Stop 命令傳遞至服務,並在 OnStop 定義時呼叫 方法。 如果未 OnStop 在服務中實作,SCM 會處理 Stop 命令。
如果 為 CanStopfalse
,SCM 會忽略 Stop 命令。 它不會傳遞至服務。 Stop 命令會傳回並擲回例外狀況。
OnStop 預期會在衍生類別中覆寫。 若要讓服務很有用, OnStart 而且 OnStop 應該在服務類別中實作。
適用於
產品 | 版本 |
---|---|
.NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |