次の方法で共有


ServiceInstaller.Install メソッド

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

Overrides Public Sub Install( _
   ByVal stateSaver As IDictionary _)
[C#]
public override void Install(IDictionarystateSaver);
[C++]
public: void Install(IDictionary* stateSaver);
[JScript]
public override function Install(
   stateSaver : IDictionary);

パラメータ

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

例外

例外の種類 条件
Exception セットアップ ツールに、実行可能ファイルの ServiceProcessInstaller が含まれていません。

または

インストールするアセンブリが見つかりませんでした。

または

サービス名が無効です。

または

サービス コントロール マネージャを開くことができませんでした。

Win32Exception サービスへのハンドルが生成できませんでした。

解説

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

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

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

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

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