EventLogInstaller.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 -> unitPublic Overrides Sub Install (stateSaver As IDictionary)パラメーター
- stateSaver
- IDictionary
ロールバックまたはアンインストール操作を実行するために必要な情報を保存するために使用する IDictionary。
例外
Source プロパティに指定された名前は、別のイベント ログに既に登録されています。
注釈
メソッドは Install 、イベント ログ情報をレジストリに書き込み、 プロパティで指定されたログにイベント ログを Log 関連付けます。 ログがまだ存在しない (ソースが指定されている) Install 場合は、ログを作成し、新しいソースをそれに関連付けます。
通常、コード内から の EventLogInstaller メソッドは呼び出しません。通常は 、Installutil.exe (インストーラー ツール) によってのみ呼び出されます。 このツールは、インストールプロセス中に メソッドを Install 自動的に呼び出して、インストールされているイベント ログに関連付けられているレジストリ情報を書き込みます。 インストールはトランザクションであるため、インストール中にインストール プロジェクト コンポーネントに障害が発生した場合は、以前にインストールされたすべてのコンポーネントがインストール前の状態にロールバックされます。 これは、各コンポーネントの Rollback メソッドを呼び出すことによって実現されます。
を使用して EventLogInstaller 、新規または既存のイベント ログの新しいソースを登録します。既存のソースを変更するには、 を使用 EventLogInstaller しないでください。 クラスは EventLogInstaller 、指定されたインストール プロパティと一致するように既存のソースの構成プロパティを変更しません。 プロパティが Install コンピューター上の別のイベント ログに Source 登録されているソース名と一致する場合、メソッドは例外をスローします。 プロパティが Install 、 プロパティで指定されたのと同じイベント ログに Source 既に登録されているソース名と一致する場合、メソッドはソースの登録を Log スキップします。
アプリケーションのインストール ルーチンは、プロジェクト インストーラーの Installer.Context プロパティを使用して、既にインストールされているコンポーネントに関する情報を自動的に保持します。 パラメーターとして stateSaver に渡されるInstallこの状態情報は、ツールが各 EventLogInstallerをインストールすると継続的に更新されます。 通常、コードでこの状態情報を明示的に変更する必要はありません。
適用対象
こちらもご覧ください
.NET