次の方法で共有

EventLogInstaller.Install メソッド

インストールを実行し、レジストリにイベント ログ情報を書き込みます。

Overrides Public Sub Install( _
   ByVal stateSaver As IDictionary _)
[C#]
public override void Install(IDictionarystateSaver);
[C++]
public: void Install(IDictionary* stateSaver);
[JScript]
public override function Install(
   stateSaver : IDictionary);

パラメータ

  • stateSaver
    ロールバックまたはアンインストール操作を実行するために必要な情報を保存するために使用する IDictionary 。

例外

例外の種類 条件
PlatformNotSupportedException インストーラが使用しようとしているプラットフォームが Windows NT 4.0 以降ではありません。

解説

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

通常、コードからは EventLogInstaller のメソッドを呼び出しません。このメソッドを呼び出すのは、一般的にインストール ユーティリティの InstallUtil.exe だけです。ユーティリティは、インストール処理中に Install メソッドを自動的に呼び出して、インストールするイベント ログに関連付けられているレジストリ情報を書き込みます。インストールはトランザクションです。そのため、インストール中にインストール プロジェクト コンポーネントのいずれかが失敗した場合は、既にインストールされていたすべてのコンポーネントがインストール前の状態にロールバックされます。ロールバックは、各コンポーネントの Rollback メソッドを呼び出すことによって実行されます。

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

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

EventLogInstaller クラス | EventLogInstaller メンバ | System.Diagnostics 名前空間 | Rollback | Uninstall | IDictionary

  • Last updated on