EventLogInstaller EventLogInstaller EventLogInstaller EventLogInstaller Class

定義

アプリケーションが実行時に読み書きするイベント ログをインストールおよび構成できます。Allows you to install and configure an event log that your application reads from or writes to when running.

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller
public class EventLogInstaller : System.Configuration.Install.ComponentInstaller
type EventLogInstaller = class
    inherit ComponentInstaller
Public Class EventLogInstaller
Inherits ComponentInstaller
継承

次のコード例では、新しいイベント ソースのインストールのプロパティを設定します。The following code example sets the installation properties for a new event source. コード例が、ソース名と、イベント ログ名を設定し、追加、EventLogInstallerInstallersコレクション。The code example sets the source name and the event log name, and adds the EventLogInstaller to the Installers collection.

#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 );
   }
};
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()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}
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
 Dim myInstaller As New EventLogInstaller()
End Class 'MyEventLogInstaller

注釈

EventLogInstallerを使って、 Installutil.exe (インストーラー ツール)イベント ログをインストールするときにします。The EventLogInstaller is used by the Installutil.exe (Installer Tool) when installing an event log. EventLogInstallerクラスがイベント ログをローカル コンピューター上でのみインストールできます。The EventLogInstaller class can install event logs only on the local computer.

使用して、EventLogInstallerクラスのアプリケーション イベント ログに書き込むときに、アプリケーションのイベント ログ インストーラーを使用して、イベント ログからの読み取りに必要なことはできません。Use the EventLogInstaller class when your application writes to an event log; it is not necessary to use an event log installer for your application to read from an event log. アプリケーションとサービスは、アプリケーション ログまたはカスタムのログに書き込む必要があります。Applications and services should write to the Application log or a custom log. デバイス ドライバーは、システム ログに書き込む必要があります。Device drivers should write to the System log.

注意

セキュリティ ログとは、読み取り専用です。The Security log is read-only.

インストーラーで指定したイベント ソースを作成する、Sourceプロパティとで指定されたイベント ログのレジスタLogプロパティ。The installer creates the event source that you specify in the Source property and registers it for the event log specified in Log property. この動作は、呼び出しに似ていますCreateEventSource上、EventLogコンポーネント。This behavior is similar to calling CreateEventSource on the EventLog component.

使用して、WriteEventWriteEntryメソッド、イベント ログにイベントを書き込みます。Use the WriteEvent and WriteEntry methods to write events to an event log. イベントを書き込むイベント ソースを指定する必要があります。作成し、ソースと最初のエントリを書き込む前に、イベント ソースを構成する必要があります。You must specify an event source to write events; you must create and configure the event source before writing the first entry with the source.

アプリケーションのインストール中に新しいイベント ソースを作成します。Create the new event source during the installation of your application. これにより、登録済みのイベント ソースの一覧とその構成を更新するオペレーティング システムまでの時間です。This allows time for the operating system to refresh its list of registered event sources and their configurations. オペレーティング システムでは、イベントのソースの一覧は更新されていない場合は、書き込み操作は失敗、新しいソースを持つイベントを記述しようとしました。If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. 使用して新しいソースを構成することができます、 EventLogInstaller、またはを使用して、CreateEventSourceメソッド。You can configure a new source using an EventLogInstaller, or using the CreateEventSource method. 新しいイベント ソースを作成するコンピューターの管理者権限が必要です。You must have administrative rights on the computer to create a new event source.

既存のイベント ログまたは新しいイベント ログのイベント ソースを作成することができます。You can create an event source for an existing event log or a new event log. 新しいイベント ログの新しいソースを作成するときに、システムがそのログのソースを登録しますが、最初のエントリが書き込まれるまで、ログは作成されません。When you create a new source for a new event log, the system registers the source for that log, but the log is not created until the first entry is written to it.

継承されるプロジェクト インストーラー クラスを作成、イベント ログをインストールするInstaller、設定、 RunInstallerAttribute 、クラスに対するtrueします。To install an event log, create a project installer class that inherits from Installer, and set the RunInstallerAttribute for the class to true. プロジェクト内に作成、EventLogInstallerの各イベント ログをアプリケーションはへの書き込みし、プロジェクト インストーラー クラスにインスタンスを追加します。Within your project, create an EventLogInstaller for each event log that your application will write to and add the instance to your project installer class.

ときに、 Installutil.exe (インストーラー ツール)が呼び出されると、検索、RunInstallerAttributeします。When the Installutil.exe (Installer Tool) is called, it looks at the RunInstallerAttribute. 場合はtrue、ツールのインストールのすべての項目、Installersプロジェクト インストーラーに関連付けられているコレクション。If it is true, the tool installs all the items in the Installers collection that are associated with your project installer. 場合RunInstallerAttributefalse、プロジェクト インストーラーが無視されます。If RunInstallerAttribute is false, the tool ignores the project installer.

他のプロパティを変更する、EventLogInstaller前に、または後にインスタンスを追加するか、Installersインストーラー ツールを実行する前に、プロジェクト インストーラーのコレクション。You modify other properties of an EventLogInstaller either before or after adding the instance to the Installers collection of your project installer, but before the installer tool runs. 設定する必要があります、Sourceプロパティの場合は、アプリケーションは、イベント ログに書き込む場合は。You must set the Source property if your application will be writing to the event log.

使用して、 EventLogInstaller ; 新規または既存のイベント ログの新しいソースを登録する使用しないでくださいEventLogInstallerを既存のソースを変更します。Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. EventLogInstallerクラスは、指定したインストールのプロパティと一致する既存のソースの構成プロパティを変更しません。The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. Install場合、メソッドが例外をスロー、Sourceコンピューター上のさまざまなイベント ログに登録されているソース名と一致するプロパティ。The Install method throws an exception if the Source property matches a source name that is registered for a different event log on the computer. Installメソッドが、ソースを登録していない場合、Sourceで指定された同じイベント ログに既に登録されているソース名と一致するプロパティ、Logプロパティ。The Install method does not register the source if the Source property matches a source name that is already registered for the same event log specified in the Log property.

イベント ソースは、イベント カテゴリ、メッセージ文字列のローカライズされたリソース ファイルを登録できます。You can register the event source with localized resource files for your event category and message strings. アプリケーションでは、実際の文字列を指定するのではなく、リソースの識別子を使用してイベント ログ エントリを書き込むことができます。Your application can write event log entries using resource identifiers, rather than specifying the actual string. イベント ビューアーでは、リソース識別子を使用して、検索し、現在の言語設定に基づいてローカライズされたリソース ファイルから、対応する文字列を表示します。The Event Viewer uses the resource identifier to find and display the corresponding string from the localized resource file based on current language settings. イベント カテゴリ、メッセージ、およびパラメーターの挿入文字列に個別のファイルを登録する、または 3 つすべての種類の文字列に同じリソース ファイルを登録することができます。You can register a separate file for event categories, messages, and parameter insertion strings, or you can register the same resource file for all three types of strings. 使用して、 CategoryCountCategoryResourceFileMessageResourceFile、およびParameterResourceFileローカライズされたエントリをイベント ログに書き込むソースを構成するプロパティ。Use the CategoryCount, CategoryResourceFile, MessageResourceFile, and ParameterResourceFile properties to configure the source to write localized entries to the event log. アプリケーションがイベント ログに直接文字列値を書き込む場合は、これらのプロパティを設定する必要はありません。If your application writes strings values directly to the event log, you do not need to set these properties.

ソースは、ローカライズされたエントリを書き込むか、または直接の文字列を書き込むように構成する必要があります。The source must be configured either for writing localized entries or for writing direct strings. アプリケーションがリソース識別子と文字列値の両方を使用してエントリを書き込む場合は、2 つの異なるソースを登録する必要があります。If your application writes entries using both resource identifiers and string values, you must register two separate sources. たとえば、リソース ファイルでは、1 つのソースを構成およびでは、そのソースを使用して、WriteEventメソッドをイベント ログのリソース識別子を使用してエントリを書き込みます。For example, configure one source with resource files, and then use that source in the WriteEvent method to write entries using resource identifiers to the event log. リソース ファイルがない場合、別のソースを作成し、そのソースを使って、WriteEntryそのソースを使用して、イベント ログに直接文字列を書き込みます。Create a different source without resource files and then use that source in the WriteEntry method to write strings directly to the event log using that source.

通常、呼び出すことはありませんのメソッド、EventLogInstallerコード内からクラスは、一般に Installutil.exe によってのみ呼び出されます。Typically, you do not call the methods of the EventLogInstaller class from within your code; they are generally called only by Installutil.exe. ツールが自動的に呼び出し、Installインストール プロセス中にメソッド。The tool automatically calls the Install method during the installation process. バックアップ実行の障害を必要に応じて、呼び出すことによって、Rollbackの例外を生成したオブジェクトのメソッド。It backs out failures, if necessary, by calling the Rollback method for the object that generated the exception.

コンストラクター

EventLogInstaller() EventLogInstaller() EventLogInstaller() EventLogInstaller()

EventLogInstaller クラスの新しいインスタンスを初期化します。Initializes a new instance of the EventLogInstaller class.

プロパティ

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CategoryCount CategoryCount CategoryCount CategoryCount

カテゴリ リソース ファイル内のカテゴリの数を取得または設定します。Gets or sets the number of categories in the category resource file.

CategoryResourceFile CategoryResourceFile CategoryResourceFile CategoryResourceFile

ソースのカテゴリ文字列が格納されたリソース ファイルのパスを取得または設定します。Gets or sets the path of the resource file that contains category strings for the source.

Container Container Container Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(Inherited from Component)
Context Context Context Context

現在のインストールに関する情報を取得または設定します。Gets or sets information about the current installation.

(Inherited from Installer)
DesignMode DesignMode DesignMode DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
HelpText HelpText HelpText HelpText

インストーラー コレクション内のすべてのインストーラーに関するヘルプ テキストを取得します。Gets the help text for all the installers in the installer collection.

(Inherited from Installer)
Installers Installers Installers Installers

インストーラーが格納しているインストーラーのコレクションを取得します。Gets the collection of installers that this installer contains.

(Inherited from Installer)
Log Log Log Log

ソースを設定するログの名前を取得または設定します。Gets or sets the name of the log to set the source to.

MessageResourceFile MessageResourceFile MessageResourceFile MessageResourceFile

ソースのメッセージ書式指定文字列が格納されたリソース ファイルのパスを取得または設定します。Gets or sets the path of the resource file that contains message formatting strings for the source.

ParameterResourceFile ParameterResourceFile ParameterResourceFile ParameterResourceFile

ソースのメッセージ パラメーター文字列が格納されたリソース ファイルのパスを取得または設定します。Gets or sets the path of the resource file that contains message parameter strings for the source.

Parent Parent Parent Parent

インストーラーが属しているコレクションを格納しているインストーラーを取得または設定します。Gets or sets the installer containing the collection that this installer belongs to.

(Inherited from Installer)
Site Site Site Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(Inherited from Component)
Source Source Source Source

ログに登録するソース名を取得または設定します。Gets or sets the source name to register with the log.

UninstallAction UninstallAction UninstallAction UninstallAction

Installutil.exe (インストーラー ツール) がアンインストール時にイベント ログを削除するか、インストールされた状態のままにしておくかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the Installutil.exe (Installer Tool) should remove the event log or leave it in its installed state at uninstall time.

メソッド

Commit(IDictionary) Commit(IDictionary) Commit(IDictionary) Commit(IDictionary)

派生クラスによってオーバーライドされた場合、インストール トランザクションを完了します。When overridden in a derived class, completes the install transaction.

(Inherited from Installer)
CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent)

インストール時に必要な EventLog コンポーネントのプロパティ値をイベント ログにコピーします。Copies the property values of an EventLog component that are required at installation time for an event log.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Install(IDictionary) Install(IDictionary) Install(IDictionary) Install(IDictionary)

インストールを実行し、レジストリにイベント ログ情報を書き込みます。Performs the installation and writes event log information to the registry.

IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller)

インストーラーが指定した別のインストーラーと同じソースを参照しているかどうかを判断します。Determines whether an installer and another specified installer refer to the same source.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary)

AfterInstall イベントを発生させます。Raises the AfterInstall event.

(Inherited from Installer)
OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary)

AfterRollback イベントを発生させます。Raises the AfterRollback event.

(Inherited from Installer)
OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary)

AfterUninstall イベントを発生させます。Raises the AfterUninstall event.

(Inherited from Installer)
OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary)

BeforeInstall イベントを発生させます。Raises the BeforeInstall event.

(Inherited from Installer)
OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary)

BeforeRollback イベントを発生させます。Raises the BeforeRollback event.

(Inherited from Installer)
OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary)

BeforeUninstall イベントを発生させます。Raises the BeforeUninstall event.

(Inherited from Installer)
OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary)

Committed イベントを発生させます。Raises the Committed event.

(Inherited from Installer)
OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary)

Committing イベントを発生させます。Raises the Committing event.

(Inherited from Installer)
Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary)

インストール プロシージャがレジストリに書き込んだイベント ログ情報をロールバックして、コンピューターをインストール前の状態に復元します。Restores the computer to the state it was in before the installation by rolling back the event log information that the installation procedure wrote to the registry.

ToString() ToString() ToString() ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(Inherited from Component)
Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary)

レジストリからイベント ログ情報を削除して、コンポーネントを削除します。Removes an installation by removing event log information from the registry.

イベント

AfterInstall AfterInstall AfterInstall AfterInstall

Installers プロパティ内のすべてのインストーラーの Install(IDictionary) メソッドが実行された後で発生します。Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Inherited from Installer)
AfterRollback AfterRollback AfterRollback AfterRollback

Installers プロパティ内のすべてのインストーラーによるインストールがロールバックされた後で発生します。Occurs after the installations of all the installers in the Installers property are rolled back.

(Inherited from Installer)
AfterUninstall AfterUninstall AfterUninstall AfterUninstall

Installers プロパティ内のすべてのインストーラーのアンインストールが実行された後で発生します。Occurs after all the installers in the Installers property perform their uninstallation operations.

(Inherited from Installer)
BeforeInstall BeforeInstall BeforeInstall BeforeInstall

インストーラー コレクション内の各インストーラーの Install(IDictionary) メソッドが実行される前に発生します。Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Inherited from Installer)
BeforeRollback BeforeRollback BeforeRollback BeforeRollback

Installers プロパティ内のインストーラーがロールバックされる前に発生します。Occurs before the installers in the Installers property are rolled back.

(Inherited from Installer)
BeforeUninstall BeforeUninstall BeforeUninstall BeforeUninstall

Installers プロパティ内のインストーラーのアンインストールが実行される前に発生します。Occurs before the installers in the Installers property perform their uninstall operations.

(Inherited from Installer)
Committed Committed Committed Committed

Installers プロパティ内のすべてのインストーラーがインストールをコミットした後で発生します。Occurs after all the installers in the Installers property have committed their installations.

(Inherited from Installer)
Committing Committing Committing Committing

Installers プロパティ内のインストーラーがインストールをコミットする前に発生します。Occurs before the installers in the Installers property commit their installations.

(Inherited from Installer)
Disposed Disposed Disposed Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

適用対象

こちらもご覧ください