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 派生します。 便利なサービスは、 メソッドと OnStop メソッドをOnStartオーバーライドします。 追加の機能については、サービス状態の変化に応じて、 と OnContinue を特定の動作でオーバーライドOnPauseできます。

サービスは、ユーザー インターフェイスをサポートせず、ログオンしたユーザー アカウントでは実行されない可能性がある、実行時間の長い実行可能ファイルです。 このサービスは、ユーザーがコンピューターにログオンしなくても実行できます。

既定では、サービスはシステム アカウントで実行されます。これは管理者アカウントと同じではありません。 システム アカウントの権限を変更することはできません。 または、 を ServiceProcessInstaller 使用して、サービスを実行するユーザー アカウントを指定することもできます。

実行可能ファイルには複数のサービスを含めることができますが、サービスごとに個別 ServiceInstaller の サービスを含める必要があります。 インスタンスは ServiceInstaller 、サービスをシステムに登録します。 インストーラーは、各サービスを、サービス コマンドの記録に使用できるイベント ログに関連付けます。 実行可能ファイルの 関数は main() 、実行するサービスを定義します。 サービスの現在の作業ディレクトリはシステム ディレクトリであり、実行可能ファイルが配置されているディレクトリではありません。

サービスを開始すると、システムは実行可能ファイルを検索し、実行可能ファイルに含まれるそのサービスの メソッドを実行 OnStart します。 ただし、サービスの実行は実行可能ファイルの実行と同じではありません。 実行可能ファイルはサービスのみを読み込みます。 サービスは、サービス コントロール マネージャーを介してアクセスされます (たとえば、開始済み、停止済み)。

実行可能ファイルは、サービスで Start を ServiceBase 初めて呼び出すと、派生クラスのコンストラクターを呼び出します。 OnStartコマンド処理メソッドは、コンストラクターの実行直後に呼び出されます。 サービスが初めて読み込まれた後、コンストラクターは再度実行されないため、コンストラクターによって実行される処理と によって OnStart実行される処理を分離する必要があります。 によって OnStop 解放できるリソースは、 で OnStart作成する必要があります。 コンストラクターでリソースを作成すると、リソースを解放した後 OnStop にサービスが再度開始された場合、リソースが適切に作成されなくなります。

サービス コントロール マネージャー (SCM) は、サービスと対話する方法を提供します。 SCM を使用して、Start、Stop、Pause、Continue、またはカスタム コマンドをサービスに渡すことができます。 SCM では、 と CanPauseAndContinue のCanStop値を使用して、サービスが Stop、Pause、または Continue コマンドを受け入れるかどうかを判断します。 SCM のコンテキスト メニューで Stop、Pause、Continue が有効になるのは、対応する プロパティ CanStop または CanPauseAndContinue が true サービス クラス内にある場合のみです。 有効にした場合、コマンドはサービスに渡され、、OnPause、OnStop、または OnContinue が呼び出されます。 、、または CanPauseAndContinue が の場合CanStop、 falseメソッドを実装した場合でも、対応するコマンド処理メソッド (などOnStop) は処理されません。 CanShutdown

クラスを使用すると、ユーザー インターフェイスを ServiceController 使用して SCM が実行する処理をプログラムで実行できます。 コンソールで使用できるタスクを自動化できます。 、CanShutdown、または CanPauseAndContinue が のtrue場合、対応するコマンド処理メソッド (などOnStop) を実装していない場合CanStop、システムは例外をスローし、コマンドを無視します。

に 、OnStop、またはその他のServiceBaseメソッドを実装OnStartする必要はありません。 ただし、サービスの動作は で OnStart説明されているため、少なくともこのメンバーをオーバーライドする必要があります。 実行可能ファイルの 関数は main() 、 メソッドを呼び出して、サービスを実行可能ファイルに Service Control Manager に Run 登録します。 メソッドにServiceBase渡されるオブジェクトの プロパティはServiceName、RunそのサービスのServiceNameサービス インストーラーの プロパティと一致する必要があります。

を使用 InstallUtil.exe して、システムにサービスをインストールできます。

コンストラクター

フィールド

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• ServiceProcessInstaller
• ServiceInstaller