WindowsServiceLifetime 类

定义

侦听关闭信号并跟踪 Windows 服务的状态。

[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
继承
属性
实现

构造函数

字段

MaxNameLength

指示服务名称的最大大小。

(继承自 ServiceBase)

属性

AutoLog

指示是否在事件日志中报告“开始”、“停止”、“暂停”和“继续”命令。

(继承自 ServiceBase)
CanHandlePowerEvent

获取或设置一个值,该值指示服务是否可以处理计算机电源状态更改的通知。

(继承自 ServiceBase)
CanHandleSessionChangeEvent

获取或设置一个值,该值指示服务是否可以处理从终端服务器会话收到的会话更改事件。

(继承自 ServiceBase)
CanPauseAndContinue

获取或设置一个值,该值指示是否可以暂停和恢复服务。

(继承自 ServiceBase)
CanRaiseEvents

获取一个值,该值指示组件是否可以引发事件。

(继承自 Component)
CanShutdown

获取或设置一个值,该值指示在关闭系统时是否应通知服务。

(继承自 ServiceBase)
CanStop

获取或设置一个值,该值指示服务在启动后是否可以停止。

(继承自 ServiceBase)
Container

获取包含 ComponentIContainer

(继承自 Component)
DesignMode

获取一个值,该值指示 Component 当前是否处于设计模式。

(继承自 Component)
EventLog

获取可用于将服务命令调用(例如启动和停止)的通知写入应用程序事件日志的事件日志。

(继承自 ServiceBase)
Events

获取附加到此 Component的事件处理程序的列表。

(继承自 Component)
ExitCode

获取或设置服务的退出代码。

(继承自 ServiceBase)
ServiceHandle

获取服务的服务控制句柄。

(继承自 ServiceBase)
ServiceName

获取或设置用于标识系统服务的短名称。

(继承自 ServiceBase)
Site

获取或设置 ComponentISite

(继承自 Component)

方法

CreateObjRef(Type)

创建一个对象,其中包含生成用于与远程对象通信的代理所需的所有相关信息。

(继承自 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() 服务控制管理器(SCM)将 Continue 命令发送到服务时运行。 指定在暂停后服务恢复正常运行时要执行的操作。

(继承自 ServiceBase)
OnCustomCommand(Int32)

在派生类中实现时,OnCustomCommand(Int32) 服务控制管理器(SCM)将自定义命令传递给服务时执行。 指定在发生具有指定参数值的命令时要执行的操作。

(继承自 ServiceBase)
OnPause()

在派生类中实现时,由服务控制管理器(SCM)将 Pause 命令发送到服务时执行。 指定服务暂停时要执行的操作。

(继承自 ServiceBase)
OnPowerEvent(PowerBroadcastStatus)

在派生类中实现时,在计算机电源状态发生更改时执行。 这适用于进入挂起模式的笔记本电脑,这与系统关闭不同。

(继承自 ServiceBase)
OnSessionChange(SessionChangeDescription)

从终端服务器会话接收更改事件时执行。

(继承自 ServiceBase)
OnShutdown()

当服务控制管理器(SCM)将关闭命令发送到服务时执行。 触发器 ApplicationStopping 并等待 ApplicationStopped。 此方法返回后不久,服务将标记为在 SCM 中停止,并且进程随时可能退出。

OnStart(String[])

在派生类中实现时,由服务控制管理器(SCM)或操作系统启动(对于自动启动的服务)发送到服务时执行 Start 命令。 指定服务启动时要执行的操作。

OnStop()

当 Service Control Manager (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()

返回一个 String,其中包含 Component的名称(如果有)。 不应重写此方法。

(继承自 Component)
WaitForStartAsync(CancellationToken)

异步等待,直到开始完成,然后继续。 此方法在 StartAsync(CancellationToken)开头调用。 这可用于延迟启动,直到外部事件发出信号。

事件

Disposed

当组件通过调用 Dispose() 方法释放时发生。

(继承自 Component)

适用于

产品 版本
.NET 6, 7, 8, 9
.NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1