ServiceBase 类

定义

public ref class ServiceBase : System::ComponentModel::Component

public class ServiceBase : System.ComponentModel.Component

type ServiceBase = class
    inherit Component

Public Class ServiceBase
Inherits Component

继承

Object

MarshalByRefObject

Component

ServiceBase

派生

Microsoft.Extensions.Hosting.WindowsServices.WindowsServiceLifetime

注解

在服务应用程序中定义服务类时派生自 ServiceBase 。 任何有用的服务都 OnStart 替代 和 OnStop 方法。 对于其他功能，可以使用特定行为替代 OnPause 和 OnContinue 以响应服务状态的更改。

服务是一个长时间运行的可执行文件，它不支持用户界面，并且可能不会在登录的用户帐户下运行。 该服务可以在没有任何用户登录到计算机的情况下运行。

默认情况下，服务在系统帐户下运行，这与管理员帐户不同。 无法更改系统帐户的权限。 或者，可以使用 ServiceProcessInstaller 来指定运行服务的用户帐户。

可执行文件可以包含多个服务，但必须为每个服务包含一个单独的 ServiceInstaller 服务。 实例 ServiceInstaller 向系统注册服务。 安装程序还会将每个服务与可用于记录服务命令的事件日志相关联。 main()可执行文件中的 函数定义应运行哪些服务。 服务的当前工作目录是系统目录，而不是可执行文件所在的目录。

启动服务时，系统会查找可执行文件，并运行 OnStart 包含在可执行文件中的该服务的方法。 但是，运行服务与运行可执行文件不同。 可执行文件仅加载服务。 访问服务 (例如，通过服务控制管理器启动和停止) 。

首次在服务上 ServiceBase 调用 Start 时，可执行文件会调用派生类的构造函数。 命令 OnStart 处理方法在执行构造函数后立即调用。 构造函数在首次加载服务后不会再次执行，因此有必要将构造函数执行的处理与 执行的 OnStart处理分开。 可通过 释放 OnStop 的任何资源都应在 中创建 OnStart。 如果在释放资源后 OnStop 再次启动服务，在构造函数中创建资源会阻止正确创建资源。

服务控制管理器 (SCM) 提供了一种与服务交互的方法。 可以使用 SCM 将 Start、Stop、Pause、Continue 或自定义命令传递到服务中。 SCM 使用 和 CanPauseAndContinue 的值CanStop来确定服务是接受 Stop、Pause 还是 Continue 命令。 仅当相应的属性 CanStop 或 CanPauseAndContinue 位于 true 服务类中时，SCM 的上下文菜单中才会启用“停止”、“暂停”和“继续”。 如果启用，则命令将传递给服务，并 OnStop调用 、 OnPause或 OnContinue 。 如果 CanStop、 CanShutdown或 CanPauseAndContinue 为 false，则不会处理相应的命令处理方法 (（如 OnStop) ），即使已实现 该方法也是如此。

可以使用 ServiceController 类以编程方式执行 SCM 使用用户界面执行的操作。 可以自动执行控制台中提供的任务。 如果 CanStop、 CanShutdown或 CanPauseAndContinue 为 true ，但尚未实现相应的命令处理方法 (（如 OnStop) 则系统将引发异常并忽略该命令。

无需在 中ServiceBase实现 OnStart、 OnStop或任何其他方法。 但是，服务的行为在 中 OnStart描述，因此至少应重写此成员。 main()可执行文件的 函数通过调用 Run 方法将可执行文件中的服务注册到服务控制管理器。 ServiceName传递给 Run 方法的 ServiceBase 对象的 属性必须与该服务的服务安装程序的 属性匹配ServiceName。

可以使用 InstallUtil.exe 在系统上安装服务。

另请参阅

• ServiceProcessInstaller
• ServiceInstaller