WindowsServiceLifetime 類別

定義

命名空間:

Microsoft.Extensions.Hosting.WindowsServices

組件:

Microsoft.Extensions.Hosting.WindowsServices.dll

套件:

Microsoft.Extensions.Hosting.WindowsServices v8.0.0

來源:

WindowsServiceLifetime.cs

接聽關機訊號，並追蹤 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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type WindowsServiceLifetime = class
    inherit ServiceBase
    interface IHostLifetime

Public Class WindowsServiceLifetime
Inherits ServiceBase
Implements IHostLifetime

繼承

Object

MarshalByRefObject

Component

ServiceBase

WindowsServiceLifetime

屬性

SupportedOSPlatformAttribute

實作

IHostLifetime

建構函式

WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>)	初始化新的 WindowsServiceLifetime 執行個體。
WindowsServiceLifetime(IHostEnvironment, IHostApplicationLifetime, ILoggerFactory, IOptions<HostOptions>, IOptions<WindowsServiceLifetimeOptions>)	接聽關機訊號，並追蹤 Windows 服務的狀態。

欄位

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 的 ISite。 (繼承來源 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)