EventLogInstaller.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)

パラメーター

例外

注釈

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

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

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

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

適用対象

こちらもご覧ください

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