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 メソッドを実行します。 ただし、サービスの実行は実行可能ファイルの実行と同じではありません。 実行可能ファイルはサービスのみを読み込みます。 サービスは、Service Control Manager を介してアクセスされます (たとえば、開始および停止)。

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

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

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

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

sc create コマンドを使用して、最新の .NET を対象とするサービスをインストールすることも、InstallUtil.exeを使用して .NET Framework を対象とするサービスをインストールすることもできます。

こちらもご覧ください

• ServiceProcessInstaller
• ServiceInstaller