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.IHostLifetime
public class WindowsServiceLifetime : System.ServiceProcess.ServiceBase, Microsoft.Extensions.Hosting.IHostLifetime
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetime
type WindowsServiceLifetime = class
inherit ServiceBase
interface IHostLifetime
Public Class WindowsServiceLifetime
Inherits ServiceBase
Implements IHostLifetime
- 繼承
- 屬性
- 實作
建構函式
欄位
MaxNameLength |
指示服務名稱的最大值。 (繼承來源 ServiceBase) |
屬性
AutoLog |
指示是否在事件記錄檔中報告啟動、停止、暫停和繼續等命令。 (繼承來源 ServiceBase) |
CanHandlePowerEvent |
取得或設定值,指出服務是否可以處理電腦電源狀態變更時發生的告知。 (繼承來源 ServiceBase) |
CanHandleSessionChangeEvent |
取得或設定值,指出服務是否可以處理從 Terminal Server 工作階段所擷取的工作階段變更事件。 (繼承來源 ServiceBase) |
CanPauseAndContinue |
取得或設定值,指出服務是否可以暫停和繼續。 (繼承來源 ServiceBase) |
CanRaiseEvents |
取得值,指出元件是否能引發事件。 (繼承來源 Component) |
CanShutdown |
取得或設定值,指出當系統關閉時是否應該通知服務。 (繼承來源 ServiceBase) |
CanStop |
取得或設定值,指出一旦服務已經啟動是否可以停止它。 (繼承來源 ServiceBase) |
Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
DesignMode |
取得值,指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
EventLog |
取得事件記錄檔,您可以利用該事件記錄將服務命令呼叫 (例如啟動和停止) 通知寫入應用程式事件記錄檔。 (繼承來源 ServiceBase) |
Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
ExitCode |
取得或設定服務的結束代碼 (Exit Code)。 (繼承來源 ServiceBase) |
ServiceHandle |
取得服務的服務控制處理。 (繼承來源 ServiceBase) |
ServiceName |
取得或設定用來識別系統服務的簡短名稱。 (繼承來源 ServiceBase) |
Site | (繼承來源 Component) |
方法
CreateObjRef(Type) |
建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject) |
Dispose() |
釋放 Component 所使用的所有資源。 (繼承來源 Component) |
Dispose(Boolean) |
釋放 WindowsServiceLifetime 使用的資源。 |
Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
GetLifetimeService() |
已淘汰.
擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject) |
GetService(Type) |
傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component) |
GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
InitializeLifetimeService() |
已淘汰.
取得存留期服務物件,以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject) |
MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
MemberwiseClone(Boolean) |
建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject) |
OnContinue() |
在衍生類別中實作時,當服務控制管理員 (SCM) 傳送繼續命令給服務時,將執行 OnContinue()。 指定暫停服務後要繼續正常運作所要執行的動作。 (繼承來源 ServiceBase) |
OnCustomCommand(Int32) |
在衍生類別中實作時,當服務控制管理員 (SCM) 傳遞自訂命令給服務時,將執行 OnCustomCommand(Int32)。 指定在具有指定參數值的命令發生時所要執行的動作。 (繼承來源 ServiceBase) |
OnPause() |
在衍生類別中實作時,當服務控制管理員 (SCM) 傳送暫停命令至服務時執行。 指定在服務暫停時所要執行的動作。 (繼承來源 ServiceBase) |
OnPowerEvent(PowerBroadcastStatus) |
在衍生類別中實作時,當電腦的電源狀態已經變更時執行。 這適用於攜帶型電腦,當它們進入暫停模式的時候,不同於系統關閉。 (繼承來源 ServiceBase) |
OnSessionChange(SessionChangeDescription) |
當從 Terminal Server 工作階段接收到變更事件時執行。 (繼承來源 ServiceBase) |
OnShutdown() |
接聽關機訊號,並追蹤 Windows 服務的狀態。 |
OnStart(String[]) |
在衍生類別中實作時,當服務控制管理員 (SCM) 傳送啟動命令至服務或當作業系統啟動 (自動啟動服務) 時執行。 指定在服務啟動時所要執行的動作。 |
OnStop() |
當 Service Control Manager (SCM) 傳送 Stop 命令至服務時執行。 ApplicationStopping觸發程式並等候 ApplicationStopped。 在此方法傳回之後不久,服務會在 SCM 中標示為已停止,而且進程可能會在任何時間點結束。 |
RequestAdditionalTime(Int32) |
要求額外時間進行暫止的運算。 (繼承來源 ServiceBase) |
RequestAdditionalTime(TimeSpan) |
從 OnStart、OnStop、OnPause 或 OnContinue 呼叫這個方法時,指定的等候提示會傳遞至服務控制管理員,以避免將服務標示為未回應。 (繼承來源 ServiceBase) |
ServiceMainCallback(Int32, IntPtr) |
登錄命令處理常式 (Command Handler) 並啟動服務。 (繼承來源 ServiceBase) |
Stop() |
停止執行中的服務。 (繼承來源 ServiceBase) |
StopAsync(CancellationToken) |
非同步停止和關閉主機。 此方法從 StopAsync(CancellationToken) 呼叫。 |
ToString() |
傳回任何包含 Component 名稱的 String。 不應覆寫此方法。 (繼承來源 Component) |
WaitForStartAsync(CancellationToken) |
以非同步方式等候,直到啟動作業完成後再繼續。 這個方法會在 StartAsync(CancellationToken) 開頭處呼叫。 這可用來將啟動延遲到外部事件發出訊號為止。 |
事件
Disposed |
當 Dispose() 方法的呼叫處置元件時,就會發生。 (繼承來源 Component) |
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應