ServiceBase.OnStop 方法

定義

在衍生類別中實作時,當服務控制管理員 (SCM) 傳送停止命令至服務時執行。 指定在服務停止執行時所要執行的動作。

protected virtual void 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)

另請參閱