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 メソッドを自動的に呼び出します。 以前にインストールしたすべてのコンポーネントで Rollback (または ServiceInstaller.Rollback) を呼び出すことで、必要に応じてエラーをバックアウトします

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

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

適用対象

こちらもご覧ください