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 プロパティを使用して、既にインストールされているコンポーネントに関する情報を自動的に保持します。 パラメーターとして stateSaver に渡されるInstallこの状態情報は、ツールが各 EventLogInstallerをインストールすると継続的に更新されます。 通常、コードでこの状態情報を明示的に変更する必要はありません。

適用対象

こちらもご覧ください