WindowsServiceLifetime 類別

定義

命名空間:

Microsoft.Extensions.Hosting.WindowsServices

組件:

Microsoft.Extensions.Hosting.WindowsServices.dll

套件:

Microsoft.Extensions.Hosting.WindowsServices v9.0.0-rc.1.24431.7

來源:

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>)	初始化 WindowsServiceLifetime 類別的新實例。

欄位

MaxNameLength

表示服務名稱的大小上限。 (繼承來源 ServiceBase)

屬性

AutoLog	指出是否要在事件記錄檔中報告 [開始]、[停止]、[暫停] 和 [繼續] 命令。 (繼承來源 ServiceBase)
CanHandlePowerEvent	取得或設定值，指出服務是否可以處理計算機電源狀態變更的通知。 (繼承來源 ServiceBase)
CanHandleSessionChangeEvent	取得或設定值，這個值表示服務是否可以處理從終端機伺服器會話接收的會話變更事件。 (繼承來源 ServiceBase)
CanPauseAndContinue	取得或設定值，指出是否可以暫停和繼續服務。 (繼承來源 ServiceBase)
CanRaiseEvents	取得值，指出元件是否可以引發事件。 (繼承來源 Component)
CanShutdown	取得或設定值，指出當系統關閉時，是否應該通知服務。 (繼承來源 ServiceBase)
CanStop	取得或設定值，指出服務啟動后是否可以停止。 (繼承來源 ServiceBase)
Container	取得包含 Component的 IContainer。 (繼承來源 Component)
DesignMode	取得值，這個值表示 Component 目前是否處於設計模式。 (繼承來源 Component)
EventLog	取得事件記錄檔，您可以用來將服務命令呼叫的通知，例如啟動和停止寫入應用程式事件記錄檔。 (繼承來源 ServiceBase)
Events	取得附加至這個 Component之事件處理程序的清單。 (繼承來源 Component)
ExitCode	取得或設定服務的結束代碼。 (繼承來源 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()	已淘汰. 擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回 物件，表示 Component 或其 Container所提供的服務。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
OnContinue()	在衍生類別中實作時，OnContinue() 當 Service Control Manager （SCM） 將 Continue 命令傳送至服務時執行。 指定當服務在暫停後繼續正常運作時要採取的動作。 (繼承來源 ServiceBase)
OnCustomCommand(Int32)	在衍生類別中實作時，OnCustomCommand(Int32) 在服務控制管理員 （SCM） 將自定義命令傳遞至服務時執行。 指定當具有指定參數值的命令發生時要採取的動作。 (繼承來源 ServiceBase)
OnPause()	在衍生類別中實作時，會在 Service Control Manager （SCM） 將 Pause 命令傳送至服務時執行。 指定服務暫停時要採取的動作。 (繼承來源 ServiceBase)
OnPowerEvent(PowerBroadcastStatus)	在衍生類別中實作時，會在計算機電源狀態變更時執行。 這適用於進入暫停模式的膝上型計算機，這與系統關機不同。 (繼承來源 ServiceBase)
OnSessionChange(SessionChangeDescription)	從終端機伺服器會話接收變更事件時執行。 (繼承來源 ServiceBase)
OnShutdown()	當服務控制管理員 （SCM） 將 Shutdown 命令傳送至服務時執行。 觸發程式 ApplicationStopping，並等候 ApplicationStopped。 在此方法傳回之後不久，服務會在 SCM 中標示為已停止，而且進程可能會在任何時間點結束。
OnStart(String[])	在衍生類別中實作時，當 Service Control Manager 傳送 Start 命令給服務時，或操作系統啟動時執行 （針對自動啟動的服務）。 指定服務啟動時要採取的動作。
OnStop()	當服務控制管理員 （SCM） 將 Stop 命令傳送至服務時執行。 觸發程式 ApplicationStopping，並等候 ApplicationStopped。 在此方法傳回之後不久，服務會在 SCM 中標示為已停止，而且進程可能會在任何時間點結束。
RequestAdditionalTime(Int32)	要求擱置作業的額外時間。 (繼承來源 ServiceBase)
RequestAdditionalTime(TimeSpan)	從 OnStart、OnStop、OnPause 或 OnContinue 呼叫此方法時，指定的等候提示會傳遞至服務控制管理員，以避免將服務標示為未回應。 (繼承來源 ServiceBase)
ServiceMainCallback(Int32, IntPtr)	註冊命令處理程式並啟動服務。 (繼承來源 ServiceBase)
Stop()	停止執行中的服務。 (繼承來源 ServiceBase)
StopAsync(CancellationToken)	以異步方式停止並關閉主機。 從 StopAsync(CancellationToken)呼叫這個方法。
ToString()	傳回包含 Component名稱的 String，如果有的話。 不應該覆寫這個方法。 (繼承來源 Component)
WaitForStartAsync(CancellationToken)	以異步方式等候開始完成，再繼續進行。 這個方法會在 StartAsync(CancellationToken)開頭呼叫。 這可用來延遲啟動，直到外部事件發出訊號為止。

事件

Disposed

當呼叫 Dispose() 方法時，就會發生元件。 (繼承來源 Component)