ServiceProcessInstaller.Install(IDictionary) メソッド

定義

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

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

パラメーター

stateSaver
IDictionary

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

例外

stateSavernull です。

注釈

通常、コード内で メソッド ServiceProcessInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に メソッドを ServiceProcessInstaller.Install 自動的に呼び出します。 以前にインストールされたすべてのコンポーネントで を呼び出 Rollback すことで、必要に応じてエラーをバックアウトします。 このメソッドは、インストールを基底クラス Installer.Install のメソッドに渡します。

通常、コード内で メソッド ServiceInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に ServiceProcessInstaller.Install メソッドと ServiceInstaller.Install メソッドを自動的に呼び出します。 必要に応じて、以前にインストールされたすべてのコンポーネントで (またはServiceInstaller.Rollback) を呼び出Rollbackすことによって、エラーをバックアウトします

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

Install は、基底クラスのメソッドまたは BeforeInstall / AfterInstall イベント ハンドラーによってスローされた例外を呼び出し元のメソッドに渡します。

適用対象

こちらもご覧ください