EventLogInstaller イベント

名前 | 説明 | |
---|---|---|
![]() | AfterInstall | Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。 ( Installer から継承されます。) |
![]() | AfterRollback | Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。 ( Installer から継承されます。) |
![]() | AfterUninstall | Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。 ( Installer から継承されます。) |
![]() | BeforeInstall | インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。 ( Installer から継承されます。) |
![]() | BeforeRollback | Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。 ( Installer から継承されます。) |
![]() | BeforeUninstall | Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。 ( Installer から継承されます。) |
![]() | Committed | Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。 ( Installer から継承されます。) |
![]() | Committing | Installers プロパティ内のインストーラがインストールをコミットする前に発生します。 ( Installer から継承されます。) |
![]() | Disposed | コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。) |

EventLogInstaller クラス
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)


EventLogInstaller は、イベント ログのインストール時にインストーラ ツール (Installutil.exe) で使用されます。EventLogInstaller クラスは、ローカル コンピュータだけにイベント ログをインストールできます。
アプリケーションがイベント ログに書き込む場合、EventLogInstaller クラスを使用します。イベント ログから読み取るアプリケーションの場合、イベント ログ インストーラを使用する必要はありません。アプリケーションおよびサービスは、アプリケーション ログまたはカスタム ログに書き込みます。デバイス ドライバは、システム ログに書き込みます。
![]() |
---|
インストーラは、Source プロパティで指定したイベント ソースを作成して、Log プロパティで指定されたイベント ログのイベント ソースとして登録します。この動作は、EventLog コンポーネントで CreateEventSource を呼び出すことに似ています。
イベントをイベント ログに書き込むには、WriteEvent メソッドおよび WriteEntry メソッドを使用します。イベントを書き込むには、イベント ソースを指定することが必要です。イベント ソースは、そのソースを持つ最初のエントリを書き込む前に作成および構成しておく必要があります。
アプリケーションのインストール時に新しいイベント ソースを作成します。これにより、オペレーティング システムが、登録されたイベント ソースとその構成の一覧を更新するための時間的余裕が生まれます。イベント ソースの一覧がオペレーティング システムにより更新されていないとき、新しいソースでイベントを書き込もうとすると、書き込み操作が失敗します。新しいソースは、EventLogInstaller または CreateEventSource メソッドを使用して構成できます。新しいイベント ソースを作成するには、コンピュータの管理者権限が必要です。
既存のイベント ログまたは新しいイベント ログのイベント ソースを作成できます。新規イベント ログに対して新しいソースを作成すると、システムは、そのログのソースを登録しますが、ログは最初のエントリが書き込まれるまで作成されません。
イベント ログをインストールするには、Installer から継承するプロジェクト インストーラ クラスを作成し、そのクラスの RunInstallerAttribute を true に設定します。プロジェクト内で、アプリケーションが書き込む各イベント ログの EventLogInstaller を作成して、プロジェクト インストーラ クラスにそのインスタンスを追加します。
インストーラ ツール (Installutil.exe) が呼び出されると、このツールは RunInstallerAttribute を検索します。true の場合、このツールは、プロジェクト インストーラに関連付けられている Installers コレクションのすべての項目をインストールします。RunInstallerAttribute が false の場合、ツールはプロジェクト インストーラを無視します。
EventLogInstaller のその他のプロパティは、プロジェクト インストーラの Installers コレクションにインスタンスを追加する前または追加した後に変更できます。ただし、この変更はインストーラ ツールを実行する前に行います。アプリケーションがイベント ログに書き込む場合は、Source プロパティを設定する必要があります。
新規のソースを新規または既存のイベント ログに登録するには、EventLogInstaller を使用します。既存のソースを変更する場合は、EventLogInstaller を使用しないでください。EventLogInstaller クラスは、指定されたインストール プロパティと一致するように既存のソースの構成プロパティを変更しません。Source プロパティが、コンピュータの別のイベント ログに登録されているソース名と一致する場合、Install メソッドは例外をスローします。Source プロパティが、Log プロパティに指定された同じイベント ログに既に登録されているソース名と一致する場合、Install メソッドはソースを登録しません。
イベント カテゴリおよびメッセージ文字列のローカライズされたリソース ファイルにイベント ソースを登録できます。アプリケーションは、実際の文字列を指定するのではなく、リソース識別子を使用してイベント ログ エントリを書き込むことができます。イベント ビューアでは、リソース識別子を使用して、ローカライズされたリソース ファイルから、現在の言語設定に基づく対応する文字列を検索して表示させることができます。イベント カテゴリ、メッセージ、およびパラメータ挿入文字列に個別のファイルを登録することも、この 3 種類の文字列に同じリソース ファイルを登録することもできます。ローカライズされたエントリをイベント ログに書き込むようにソースを構成するには、CategoryCount、CategoryResourceFile、MessageResourceFile、および ParameterResourceFile の各プロパティを使用します。アプリケーションが文字列値を直接イベント ログに書き込む場合、これらのプロパティを設定する必要はありません。
ソースは、ローカライズされたエントリを書き込むか、または直接の文字列を書き込むように構成されている必要があります。アプリケーションがリソース識別子と文字列値の両方を使用してエントリを書き込む場合、2 つの異なるソースを登録する必要があります。たとえば、複数のリソース ファイルを持つ 1 つのソースを構成してから、WriteEvent メソッドでこのソースを使用し、リソース識別子によってエントリをイベント ログに書き込みます。リソース ファイルを使わずに作成した別のソースを WriteEntry メソッドで使用し、そのソースを使って文字列を直接イベント ログに書き込みます。
通常、コードからは EventLogInstaller クラスのメソッドを呼び出しません。このメソッドを呼び出すのは、一般的に InstallUtil.exe だけです。このツールは、インストール処理中に Install メソッドを自動的に呼び出します。必要に応じて、例外を生成したオブジェクトに対して Rollback メソッドを呼び出すことにより、エラーを回復します。
Windows 98, Windows Millennium Edition プラットフォームメモ : イベント ログは、Windows 98 または Windows Millennium Edition (Me) ではサポートされていません。

新しいイベント ソースのインストール プロパティを設定するコード例を次に示します。このコード例は、ソース名とイベント ログ名を設定し、Installers コレクションに EventLogInstaller を追加します。
Imports System Imports System.Configuration.Install Imports System.Diagnostics Imports System.ComponentModel <RunInstaller(True)> _ Public Class MyEventLogInstaller Inherits Installer Private myEventLogInstaller As EventLogInstaller Public Sub New() ' Create an instance of an EventLogInstaller. myEventLogInstaller = New EventLogInstaller() ' Set the source name of the event log. myEventLogInstaller.Source = "NewLogSource" ' Set the event log that the source writes entries to. myEventLogInstaller.Log = "MyNewLog" ' Add myEventLogInstaller to the Installer collection. Installers.Add(myEventLogInstaller) End Sub 'New Public Shared Sub Main() End Sub 'Main End Class 'MyEventLogInstaller
using System; using System.Configuration.Install; using System.Diagnostics; using System.ComponentModel; [RunInstaller(true)] public class MyEventLogInstaller: Installer { private EventLogInstaller myEventLogInstaller; public MyEventLogInstaller() { // Create an instance of an EventLogInstaller. myEventLogInstaller = new EventLogInstaller(); // Set the source name of the event log. myEventLogInstaller.Source = "NewLogSource"; // Set the event log that the source writes entries to. myEventLogInstaller.Log = "MyNewLog"; // Add myEventLogInstaller to the Installer collection. Installers.Add(myEventLogInstaller); } public static void Main() { } }
#using <System.dll> #using <System.Configuration.Install.dll> using namespace System; using namespace System::Configuration::Install; using namespace System::Diagnostics; using namespace System::ComponentModel; [RunInstaller(true)] ref class MyEventLogInstaller: public Installer { private: EventLogInstaller^ myEventLogInstaller; public: MyEventLogInstaller() { // Create an instance of an EventLogInstaller. myEventLogInstaller = gcnew EventLogInstaller; // Set the source name of the event log. myEventLogInstaller->Source = "NewLogSource"; // Set the event log that the source writes entries to. myEventLogInstaller->Log = "MyNewLog"; // Add myEventLogInstaller to the Installer collection. Installers->Add( myEventLogInstaller ); } };
import System.*; import System.Configuration.Install.*; import System.Diagnostics.*; import System.ComponentModel.*; /** @attribute RunInstaller(true) */ public class MyEventLogInstaller extends Installer { private EventLogInstaller myEventLogInstaller; public MyEventLogInstaller() { // Create an instance of an EventLogInstaller. myEventLogInstaller = new EventLogInstaller(); // Set the source name of the event log. myEventLogInstaller.set_Source("NewLogSource"); // Set the event log that the source writes entries to. myEventLogInstaller.set_Log("MyNewLog"); // Add myEventLogInstaller to the Installer collection. this.get_Installers().Add(myEventLogInstaller); } //MyEventLogInstaller public static void main(String[] args) { } //main } //MyEventLogInstaller

System.MarshalByRefObject
System.ComponentModel.Component
System.Configuration.Install.Installer
System.Configuration.Install.ComponentInstaller
System.Diagnostics.EventLogInstaller


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


EventLogInstaller コンストラクタ
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)



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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


EventLogInstaller プロパティ

名前 | 説明 | |
---|---|---|
![]() | CategoryCount | カテゴリ リソース ファイル内のカテゴリの数を取得または設定します。 |
![]() | CategoryResourceFile | ソースのカテゴリ文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | Container | Component を格納している IContainer を取得します。 ( Component から継承されます。) |
![]() | Context | 現在のインストールに関する情報を取得または設定します。 ( Installer から継承されます。) |
![]() | HelpText | インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。 ( Installer から継承されます。) |
![]() | Installers | インストーラが格納しているインストーラのコレクションを取得します。 ( Installer から継承されます。) |
![]() | Log | ソースを設定するログの名前を取得または設定します。 |
![]() | MessageResourceFile | ソースのメッセージ書式指定文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | ParameterResourceFile | ソースのメッセージ パラメータ文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | Parent | インストーラが属しているコレクションを格納しているインストーラを取得または設定します。 ( Installer から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。 ( Component から継承されます。) |
![]() | Source | ログに登録するソース名を取得または設定します。 |
![]() | UninstallAction | インストーラ ツール (Installutil.exe) がアンインストール時にイベント ログを削除するか、インストールされた状態のままにしておくかどうかを示す値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。) |

EventLogInstaller メソッド


名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。) |
![]() | Finalize | Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。) |
![]() | GetService | Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |
![]() | OnAfterInstall | AfterInstall イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnAfterRollback | AfterRollback イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnAfterUninstall | AfterUninstall イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnBeforeInstall | BeforeInstall イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnBeforeRollback | BeforeRollback イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnBeforeUninstall | BeforeUninstall イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnCommitted | Committed イベントを発生させます。 ( Installer から継承されます。) |
![]() | OnCommitting | Committing イベントを発生させます。 ( Installer から継承されます。) |

EventLogInstaller メンバ
アプリケーションが実行時に読み書きするイベント ログをインストールおよび構成できます。
EventLogInstaller データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | CategoryCount | カテゴリ リソース ファイル内のカテゴリの数を取得または設定します。 |
![]() | CategoryResourceFile | ソースのカテゴリ文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | Container | Component を格納している IContainer を取得します。(Component から継承されます。) |
![]() | Context | 現在のインストールに関する情報を取得または設定します。(Installer から継承されます。) |
![]() | HelpText | インストーラ コレクション内のすべてのインストーラに関するヘルプ テキストを取得します。(Installer から継承されます。) |
![]() | Installers | インストーラが格納しているインストーラのコレクションを取得します。(Installer から継承されます。) |
![]() | Log | ソースを設定するログの名前を取得または設定します。 |
![]() | MessageResourceFile | ソースのメッセージ書式指定文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | ParameterResourceFile | ソースのメッセージ パラメータ文字列が格納されたリソース ファイルのパスを取得または設定します。 |
![]() | Parent | インストーラが属しているコレクションを格納しているインストーラを取得または設定します。(Installer から継承されます。) |
![]() | Site | Component の ISite を取得または設定します。(Component から継承されます。) |
![]() | Source | ログに登録するソース名を取得または設定します。 |
![]() | UninstallAction | インストーラ ツール (Installutil.exe) がアンインストール時にイベント ログを削除するか、インストールされた状態のままにしておくかどうかを示す値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。) |
![]() | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。) |
![]() | Events | Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。) |


名前 | 説明 | |
---|---|---|
![]() | Dispose | オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。) |
![]() | Finalize | Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。) |
![]() | GetService | Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。) |
![]() | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |
![]() | OnAfterInstall | AfterInstall イベントを発生させます。 (Installer から継承されます。) |
![]() | OnAfterRollback | AfterRollback イベントを発生させます。 (Installer から継承されます。) |
![]() | OnAfterUninstall | AfterUninstall イベントを発生させます。 (Installer から継承されます。) |
![]() | OnBeforeInstall | BeforeInstall イベントを発生させます。 (Installer から継承されます。) |
![]() | OnBeforeRollback | BeforeRollback イベントを発生させます。 (Installer から継承されます。) |
![]() | OnBeforeUninstall | BeforeUninstall イベントを発生させます。 (Installer から継承されます。) |
![]() | OnCommitted | Committed イベントを発生させます。 (Installer から継承されます。) |
![]() | OnCommitting | Committing イベントを発生させます。 (Installer から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | AfterInstall | Installers プロパティ内のすべてのインストーラの Install メソッドが実行された後で発生します。(Installer から継承されます。) |
![]() | AfterRollback | Installers プロパティ内のすべてのインストーラによるインストールがロールバックされた後で発生します。(Installer から継承されます。) |
![]() | AfterUninstall | Installers プロパティ内のすべてのインストーラのアンインストールが実行された後で発生します。(Installer から継承されます。) |
![]() | BeforeInstall | インストーラ コレクション内の各インストーラの Install メソッドが実行される前に発生します。(Installer から継承されます。) |
![]() | BeforeRollback | Installers プロパティ内のインストーラによるインストールがロールバックされる前に発生します。(Installer から継承されます。) |
![]() | BeforeUninstall | Installers プロパティ内のインストーラのアンインストールが実行される前に発生します。(Installer から継承されます。) |
![]() | Committed | Installers プロパティ内のすべてのインストーラがインストールをコミットした後で発生します。(Installer から継承されます。) |
![]() | Committing | Installers プロパティ内のインストーラがインストールをコミットする前に発生します。(Installer から継承されます。) |
![]() | Disposed | コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。) |

- EventLogInstallerのページへのリンク