ServiceProcessInstaller.Install(IDictionary) メソッド

定義

名前空間:

System.ServiceProcess

アセンブリ:

System.ServiceProcess.dll

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

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。

例外

ArgumentException

stateSaver は null です。

注釈

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

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

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

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

こちらもご覧ください

• Rollback(IDictionary)
• Commit(IDictionary)
• Uninstall(IDictionary)