Language

EventLogInstaller.Install(IDictionary) メソッド

定義

名前空間:
System.Diagnostics
アセンブリ:
System.Configuration.Install.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

Source プロパティで指定された名前は、別のイベント ログに既に登録されています。

注釈

Install メソッドは、イベント ログ情報をレジストリに書き込み、イベント ログを Log プロパティで指定されたログに関連付けます。 ログがまだ存在しない場合 (およびソースが指定されている場合)、 Install ログが作成され、新しいソースがログに関連付けられます。

通常、 EventLogInstaller のメソッドはコード内から呼び出しません。通常、 Installutil.exe (インストーラー ツール) によってのみ呼び出されます。 このツールは、インストールプロセス中に Install メソッドを自動的に呼び出して、インストールされているイベント ログに関連付けられているレジストリ情報を書き込みます。 インストールはトランザクションであるため、インストール中にインストール プロジェクト コンポーネントに障害が発生した場合、以前にインストールされたすべてのコンポーネントは、インストール前の状態にロールバックされます。 これは、各コンポーネントの Rollback メソッドを呼び出すことによって実現されます。

EventLogInstallerを使用して、新規または既存のイベント ログの新しいソースを登録します。既存のソースを変更するEventLogInstallerは使用しないでください。 EventLogInstaller クラスは、指定したインストール プロパティに一致するように既存のソースの構成プロパティを変更しません。 Install プロパティが、コンピューター上の別のイベント ログに登録されているソース名と一致する場合、Source メソッドは例外をスローします。 Install メソッドは、Source プロパティが、Log プロパティで指定されたのと同じイベント ログに既に登録されているソース名と一致する場合、ソースの登録をスキップします。

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

適用対象

こちらもご覧ください