ServiceProcessInstaller.Install(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サービス アプリケーション情報をレジストリに書き込みます。 このメソッドは、セットアップ ツールで使用されます。セットアップ ツールは適切なメソッドを自動的に呼び出します。
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。
例外
stateSaver
は null
です。
注釈
通常、コード内で メソッド ServiceProcessInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に メソッドを ServiceProcessInstaller.Install 自動的に呼び出します。 以前にインストールされたすべてのコンポーネントで を呼び出 Rollback すことで、必要に応じてエラーをバックアウトします。 このメソッドは、インストールを基底クラス Installer.Install のメソッドに渡します。
通常、コード内で メソッド ServiceInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に ServiceProcessInstaller.Install メソッドと ServiceInstaller.Install メソッドを自動的に呼び出します。 必要に応じて、以前にインストールされたすべてのコンポーネントで (またはServiceInstaller.Rollback) を呼び出Rollbackすことによって、エラーをバックアウトします
アプリケーションのインストール ルーチンでは、プロジェクト インストーラーの を使用して、既にインストールされているコンポーネントに関する情報が Installer.Context自動的に保持されます。 パラメーターとして渡Installされたこの状態情報は、インスタンスとしてstateSaver
ServiceProcessInstaller継続的に更新され、各ServiceInstallerインスタンスはユーティリティによってインストールされます。 通常、コードでこの状態情報を明示的に変更する必要があります。
Install は、基底クラスのメソッドまたは BeforeInstall / AfterInstall イベント ハンドラーによってスローされた例外を呼び出し元のメソッドに渡します。
適用対象
こちらもご覧ください
.NET