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 方法。 不過，執行服務與執行可執行檔不同。 可執行檔只會載入服務。 服務 (存取，例如透過服務控制管理員啟動和停止) 。

可執行檔會在您第一次在服務上呼叫 Start 時呼叫 ServiceBase 衍生類別的建構函式。 在 OnStart 建構函式執行之後，會立即呼叫命令處理方法。 第一次載入服務之後，不會再次執行建構函式，因此您必須將建構函式所執行的處理與 所 OnStart 執行的分開。 任何可以釋出 OnStop 的資源都應該在 中 OnStart 建立。 在建構函式中建立資源可防止在釋放資源之後再次啟動服務時 OnStop 正確建立資源。

服務控制管理員 (SCM) 提供與服務互動的方式。 您可以使用 SCM 將 Start、Stop、Pause、Continue 或自訂命令傳遞至服務。 SCM 會使用 和 CanPauseAndContinue 的值 CanStop 來判斷服務是否接受 Stop、Pause 或 Continue 命令。 只有在對應的屬性 CanStop 或位於 true 服務類別時，SCM 操作功能表中才會啟用 Stop、Pause 和 CanPauseAndContinue Continue。 如果啟用，命令會傳遞至服務，並 OnStop 呼叫 、 OnPause 或 OnContinue 。 如果 CanStop 、 CanShutdown 或 CanPauseAndContinue 為 false ，則即使您已實作 方法，對應的命令處理方法 (例如 OnStop) 也不會處理。

您可以使用 類別 ServiceController ，以程式設計方式執行 SCM 使用使用者介面的功能。 您可以將主控台中可用的工作自動化。 如果 CanStop 為 、 CanShutdown 或 CanPauseAndContinue ， true 但尚未實作對應的命令處理方法， (例如 OnStop) 系統擲回例外狀況並忽略命令。

您不需要在 中實 OnStart 作 ServiceBase 、 OnStop 或任何其他方法。 不過，服務的行為會在 中 OnStart 描述，因此至少應該覆寫此成員。 可執行檔 main() 的函式會呼叫 Run 方法，向服務控制管理員註冊可執行檔中的服務。 ServiceName傳遞給 Run 方法之 ServiceBase 物件的 屬性必須符合 ServiceName 該服務之服務安裝程式的 屬性。

您可以使用 InstallUtil.exe 在系統上安裝服務。

建構函式

欄位

屬性

方法

事件

適用於

另請參閱

• ServiceProcessInstaller
• ServiceInstaller