ServiceInstaller.Install メソッド

.NET Framework クラス ライブラリ リファレンス

ServiceInstaller.Install メソッド

サービス アプリケーション情報をレジストリに書き込んで、サービスをインストールします。このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に処理します。

名前空間: System.ServiceProcess
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Install
 ( _
    stateSaver As IDictionary _
)

Visual Basic (使用法)

Dim instance As ServiceInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

C#

public override void Install (
    IDictionary stateSaver
)

C++

public:
virtual void Install (
    IDictionary^ stateSaver
) override

J#

public void Install (
    IDictionary stateSaver
)

JScript

public override function Install (
    stateSaver : IDictionary
)

パラメータ

stateSaver

インストールに関連付けられているコンテキスト情報を格納する IDictionary。

例外

例外の種類	条件
Exception	セットアップ ツールに、実行可能ファイルの ServiceProcessInstaller が含まれていません。 または インストールするアセンブリが見つかりませんでした。 または サービス名が無効です。 または サービス コントロール マネージャを開くことができませんでした。
Win32Exception	サービスへのハンドルが生成できませんでした。

解説

通常、コード内の ServiceInstaller では、これらのメソッドを呼び出しません。これらのメソッドを呼び出すのは、一般にはインストール ユーティリティだけです。インストール ユーティリティは、インストール中に Install メソッドを自動的に呼び出します。必要に応じて、例外を生成したオブジェクトに対して Rollback を呼び出すことにより、エラーを回復します。

アプリケーションのインストール ルーチンは、既にインストールされているコンポーネントに関する情報を、プロジェクト インストーラの Installer.Context を使用して自動的に維持します。この状態情報は、Install に stateSaver パラメータとして渡され、ServiceProcessInstaller インスタンスとして継続的に更新されます。各 ServiceInstaller インスタンスは、ユーティリティでインストールされます。通常、コードではこの状態情報を明示的に変更する必要はありません。

プロジェクト インストール クラスに関連付けられた ServiceProcessInstaller は、プロジェクト内のすべての ServiceInstaller インスタンスに共通の情報をインストールします。サービスにインストール プロジェクト内の他のサービスと区別される内容が含まれている場合は、このメソッドによってサービスに固有の情報がインストールされます。

サービスをインストールするには、Installer クラスから継承するプロジェクト インストーラ クラスを作成し、そのクラスの RunInstallerAttribute 属性を true に設定します。プロジェクト内では、サービス アプリケーションごとに 1 つの ServiceProcessInstaller インスタンス、およびアプリケーション内の各サービスにつき 1 つの ServiceInstaller インスタンスを作成します。プロジェクト インストーラ クラス コンストラクタ内で、ServiceProcessInstaller および ServiceInstaller インスタンスを使用してサービスのインストール プロパティを設定し、そのインスタンスを Installers コレクションに追加します。

メモ
インストーラ インスタンスを追加する場合にはコンストラクタを使用することをお勧めします。ただし、Install メソッド内の Installers コレクションに追加する必要がある場合は、Uninstall メソッド内のコレクションにも同じように追加する必要があります。

Installer クラスから派生するクラスの場合、Installers コレクションの状態は、Install および Uninstall メソッド内と同じである必要があります。ただし、インスタンスをカスタム インストーラ クラス コンストラクタ内の Installers コレクションに追加した場合は、コレクションを Install メソッドおよび Uninstall メソッド間で保持する必要はありません。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceInstaller クラス
ServiceInstaller メンバ
System.ServiceProcess 名前空間
ServiceProcessInstaller
Rollback
Installer.Commit
Uninstall
EventLogInstaller
EventLogInstaller