EventLogInstaller.Install メソッド

.NET Framework クラス ライブラリ リファレンス

EventLogInstaller.Install メソッド

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

名前空間: System.Diagnostics
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Install
 ( _
    stateSaver As IDictionary _
)

Visual Basic (使用法)

Dim instance As EventLogInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

C#

public override void Install (
    IDictionary stateSaver
)

C++

public:
virtual void Install (
    IDictionary^ stateSaver
) override

J#

public void Install (
    IDictionary stateSaver
)

JScript

public override function Install (
    stateSaver : IDictionary
)

パラメータ

stateSaver

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

例外

例外の種類	条件
PlatformNotSupportedException	インストーラが使用しようとしているプラットフォームが Windows NT 4.0 以降ではありません。
ArgumentException	Source プロパティに指定された名前は、別のイベント ログに既に登録されています。

解説

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

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

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

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
EventLogInstaller クラス
EventLogInstaller メンバ
System.Diagnostics 名前空間
Rollback
Uninstall
IDictionary