WindowsServiceLifetime 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
監聽關機訊號並追蹤 Windows 服務狀態。
public ref class WindowsServiceLifetime : System::ServiceProcess::ServiceBase, Microsoft::Extensions::Hosting::IHostLifetime[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetimepublic class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetime[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetimetype WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetimePublic Class WindowsServiceLifetime
Inherits ServiceBase
Implements IHostLifetime- 繼承
- 屬性
- 實作
建構函式
欄位
| 名稱 | Description |
|---|---|
| MaxNameLength |
表示服務名稱的最大容量。 (繼承來源 ServiceBase) |
屬性
| 名稱 | Description |
|---|---|
| AutoLog |
指示是否要在事件日誌中回報 Start、Stop、Pause 和 Continued 指令。 (繼承來源 ServiceBase) |
| CanHandlePowerEvent |
取得或設定一個值，表示服務是否能處理電腦電源狀態變更的通知。 (繼承來源 ServiceBase) |
| CanHandleSessionChangeEvent |
取得或設定一個值，指示服務是否能處理從終端伺服器會話接收到的會話變更事件。 (繼承來源 ServiceBase) |
| CanPauseAndContinue |
取得或設定一個值，表示服務是否可以暫停與恢復。 (繼承來源 ServiceBase) |
| CanShutdown |
會取得或設定一個值，指示系統關閉時是否應通知服務。 (繼承來源 ServiceBase) |
| CanStop |
取得或設定一個值，表示服務一旦啟動後是否可以停止。 (繼承來源 ServiceBase) |
| EventLog |
會取得一個事件日誌，你可以用來寫入服務指令呼叫的通知，例如開始和停止，並寫入應用程式事件日誌。 (繼承來源 ServiceBase) |
| ExitCode |
取得或設定該服務的出口代碼。 (繼承來源 ServiceBase) |
| ServiceHandle |
取得服務控制的控制柄。 (繼承來源 ServiceBase) |
| ServiceName |
取得或設定用來識別系統服務的簡稱。 (繼承來源 ServiceBase) |
方法
| 名稱 | Description |
|---|---|
| Dispose(Boolean) |
釋放 所使用的 WindowsServiceLifetime資源。 |
| OnContinue() |
當在衍生類別中實作時，當服務控制管理器（SCM）向服務發送 Continue 指令時，會 OnContinue() 執行。 規定服務暫停後恢復正常運作時應採取的行動。 (繼承來源 ServiceBase) |
| OnCustomCommand(Int32) |
當在衍生類別中實作時，當 OnCustomCommand(Int32) 服務控制管理器（SCM）將自訂指令傳給服務時執行。 指定當指令出現指定參數值時應採取的動作。 (繼承來源 ServiceBase) |
| OnPause() |
當在衍生類別中實作時，當服務控制管理器（SCM）向服務發送暫停指令時執行。 指定服務暫停時應採取的行動。 (繼承來源 ServiceBase) |
| OnPowerEvent(PowerBroadcastStatus) |
當以衍生類別實作時，當電腦的電源狀態改變時執行。 這適用於筆記型電腦進入暫停模式（與系統關機不同）。 (繼承來源 ServiceBase) |
| OnSessionChange(SessionChangeDescription) |
當從終端伺服器會話接收變更事件時執行。 (繼承來源 ServiceBase) |
| OnShutdown() |
當服務控制管理器（SCM）向服務發送關機指令時執行。 |
| OnStart(String[]) |
當以衍生類別實作時，當服務控制管理器（SCM）向服務發送啟動指令，或作業系統啟動（自動啟動的服務）時執行。 指定服務開始時應採取的行動。 |
| OnStop() |
當服務控制管理器（SCM）向服務發送停止指令時執行。 |
| RequestAdditionalTime(Int32) |
請求因待定手術延長時間。 (繼承來源 ServiceBase) |
| RequestAdditionalTime(TimeSpan) |
當此方法由 OnStart、OnStop、OnPause 或 OnContinue 呼叫時，指定的等待提示會傳達給服務控制管理員，以避免服務被標記為無回應。 (繼承來源 ServiceBase) |
| ServiceMainCallback(Int32, IntPtr) |
註冊指令處理器並啟動服務。 (繼承來源 ServiceBase) |
| Stop() |
這樣會停止執行中的服務。 (繼承來源 ServiceBase) |
| StopAsync(CancellationToken) |
非同步停止並關閉主機。 此方法稱為 。StopAsync(CancellationToken) |
| WaitForStartAsync(CancellationToken) |
非同步等待開始完成後再繼續。 此方法在 的 StartAsync(CancellationToken)開頭稱為。 這可用來將啟動延遲到外部事件發出訊號為止。 |
