EventLogInstallerとは? わかりやすく解説

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.Diagnostics 名前空間
EventLog クラス
CreateEventSource

その他の技術情報

インストーラ ツール (Installutil.exe)

EventLogInstaller クラス

アプリケーション実行時読み書きするイベント ログインストールおよび構成できます

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

Public Class EventLogInstaller
    Inherits ComponentInstaller
Dim instance As EventLogInstaller
public class EventLogInstaller : ComponentInstaller
public ref class EventLogInstaller : public
 ComponentInstaller
public class EventLogInstaller extends ComponentInstaller
public class EventLogInstaller extends
 ComponentInstaller
解説解説

EventLogInstaller は、イベント ログインストール時インストーラ ツール (Installutil.exe) で使用されます。EventLogInstaller クラスは、ローカル コンピュータだけにイベント ログインストールできます

アプリケーションイベント ログ書き込む場合EventLogInstaller クラス使用しますイベント ログから読み取るアプリケーション場合イベント ログ インストーラ使用する要はありません。アプリケーションおよびサービスは、アプリケーション ログまたはカスタム ログ書き込みますデバイス ドライバは、システム ログ書き込みます

メモメモ

セキュリティ ログ読み取り専用です。

インストーラは、Source プロパティ指定したイベント ソース作成してLog プロパティ指定されイベント ログイベント ソースとして登録します。この動作は、EventLog コンポーネントで CreateEventSource を呼び出すことに似てます。

イベントイベント ログ書き込むには、WriteEvent メソッドおよび WriteEntry メソッド使用しますイベント書き込むには、イベント ソース指定することが必要です。イベント ソースは、そのソースを持つ最初のエントリを書き込む前に作成および構成しておく必要があります

アプリケーションのインストール時に新しイベント ソース作成します。これにより、オペレーティング システムが、登録されイベント ソースその構成の一覧を更新するための時間的余裕生まれますイベント ソースの一覧がオペレーティング システムにより更新されていないとき、新しソースイベント書き込もうとすると、書き込み操作失敗します新しソースは、EventLogInstaller または CreateEventSource メソッド使用して構成できます新しイベント ソース作成するには、コンピュータ管理者権限が必要です。

既存イベント ログまたは新しイベント ログイベント ソース作成できます新規イベント ログに対して新しソース作成すると、システムは、そのログソース登録しますが、ログ最初のエントリが書き込まれるまで作成されません。

イベント ログインストールするには、Installer から継承するプロジェクト インストーラ クラス作成し、そのクラスの RunInstallerAttribute を true設定しますプロジェクト内で、アプリケーション書き込むイベント ログEventLogInstaller作成してプロジェクト インストーラ クラスにそのインスタンス追加します

インストーラ ツール (Installutil.exe) が呼び出されると、このツールRunInstallerAttribute検索しますtrue場合、このツールは、プロジェクト インストーラ関連付けられている Installers コレクションすべての項目をインストールます。RunInstallerAttributefalse場合ツールプロジェクト インストーラ無視します。

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.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Configuration.Install.Installer
         System.Configuration.Install.ComponentInstaller
          System.Diagnostics.EventLogInstaller
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

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) がアンインストール時にイベント ログ削除するか、インストールされた状態のままにしておくかどうかを示す値を取得または設定します
プロテクト プロパティプロテクト プロパティ
参照参照

関連項目

EventLogInstaller クラス
System.Diagnostics 名前空間
EventLog クラス
CreateEventSource

その他の技術情報

インストーラ ツール (Installutil.exe)

EventLogInstaller メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Commit  派生クラスによってオーバーライドされた場合インストール トランザクション完了します。 ( Installer から継承されます。)
パブリック メソッド CopyFromComponent オーバーライドされますインストール時必要な EventLog コンポーネントプロパティ値をイベント ログコピーします
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされますComponent によって使用されているリソース解放します。 ( Component から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 ( Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Install オーバーライドされますインストール実行しレジストリイベント ログ情報書き込みます
パブリック メソッド IsEquivalentInstaller オーバーライドされますインストーラ指定した別のインストーラと同じソース参照しているかどうか判断します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド Rollback オーバーライドされますインストール プロシージャレジストリ書き込んだイベント ログ情報ロールバックして、コンピュータインストール前の状態に復元します。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 ( Component から継承されます。)
パブリック メソッド Uninstall オーバーライドされますレジストリからイベント ログ情報削除してコンポーネント削除します
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド 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 クラス
System.Diagnostics 名前空間
EventLog クラス
CreateEventSource

その他の技術情報

インストーラ ツール (Installutil.exe)

EventLogInstaller メンバ

アプリケーション実行時読み書きするイベント ログインストールおよび構成できます

EventLogInstaller データ型公開されるメンバを以下の表に示します


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド 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) がアンインストール時にイベント ログ削除するか、インストールされた状態のままにしておくかどうかを示す値を取得または設定します
プロテクト プロパティプロテクト プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Commit  派生クラスによってオーバーライドされた場合インストール トランザクション完了します。 (Installer から継承されます。)
パブリック メソッド CopyFromComponent オーバーライドされますインストール時必要な EventLog コンポーネントプロパティ値をイベント ログコピーします
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信使用するプロキシ生成必要な情報をすべて格納しているオブジェクト作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose  オーバーロードされますComponent によって使用されているリソース解放します。 (Component から継承されます。)
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 (Object から継承されます。)
パブリック メソッド GetLifetimeService  対象インスタンス有効期間ポリシー制御する現在の有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド InitializeLifetimeService  対象インスタンス有効期間ポリシー制御する有効期間サービス オブジェクト取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Install オーバーライドされますインストール実行しレジストリイベント ログ情報書き込みます
パブリック メソッド IsEquivalentInstaller オーバーライドされますインストーラ指定した別のインストーラと同じソース参照しているかどうか判断します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド Rollback オーバーライドされますインストール プロシージャレジストリ書き込んだイベント ログ情報ロールバックして、コンピュータインストール前の状態に復元します。
パブリック メソッド ToString  Component の名前を格納している String返します (存在する場合)。このメソッドオーバーライドできません。 (Component から継承されます。)
パブリック メソッド Uninstall オーバーライドされますレジストリからイベント ログ情報削除してコンポーネント削除します
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド 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 クラス
System.Diagnostics 名前空間
EventLog クラス
CreateEventSource

その他の技術情報

インストーラ ツール (Installutil.exe)



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「EventLogInstaller」の関連用語

EventLogInstallerのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



EventLogInstallerのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS