EventLog クラス

[アーティクル]
03/28/2008

Windows のイベントログとの対話を実現します。

この型のすべてのメンバの一覧については、EventLog メンバを参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Diagnostics.EventLog

Public Class EventLog
   Inherits Component
   Implements ISupportInitialize
[C#]
public class EventLog : Component, ISupportInitialize
[C++]
public __gc class EventLog : public Component, ISupportInitialize
[JScript]
public class EventLog extends Component implements
   ISupportInitialize

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

EventLog を使用すると、重要なソフトウェアイベントまたはハードウェアイベントについての情報を記録する Windows 2000 のイベントログへのアクセスやカスタマイズが可能になります。 EventLog を使用して、既存のログからの読み取り、ログへのエントリの書き込み、イベントソースの作成や削除、ログエントリへの応答などを行うことができます。また、イベントソースの作成時に新しいログを作成することもできます。

CreateEventSource の呼び出しで指定したログがコンピュータに存在しない場合は、システムによってカスタムログが作成され、アプリケーションがそのログのソースとして登録されます。適切なアクセス許可のあるイベントログに対してエントリの読み取り/書き込みを行うには、 EventLog クラスを使用します。

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

イベントログに書き込む場合は、イベント Source を指定するか、または作成する必要があります。 Source は、アプリケーションを有効なソースとしてイベントログに登録します。 Source は、同時に 1 つのログに書き込むときだけ使用できます。 Source には任意のランダムな文字列を指定できますが、コンピュータの他のソースとは別の一意の名前である必要があります。通常、ソース名には、アプリケーション名またはその他の識別用文字列を使用します。重複する Source 値を作成しようとすると、例外がスローされます。ただし、単一のイベントログを複数のソースに関連付けることは可能です。

ログを読み取るには、 EventLog に Log 名と MachineName (サーバーコンピュータ名) を指定します。ソースが必要なのはログに書き込む場合だけであるため、 Source を指定する必要はありません。 Entries メンバには、自動的にイベントログのエントリリストが設定されます。

メモ Log/ MachineName のペアを指定してログに接続している場合は、 MachineName を指定する必要はありません。 MachineName を指定しなかった場合は、ローカルコンピュータ "." が想定されます。

イベントログに書き込む場合は、 message パラメータで送信する情報の種類を指定できます。メッセージを送信するだけではなく、 EventLogEntryType を送信して、そのメッセージが Error ("エラー")、Warning ("警告")、Information ("情報") のいずれであるかを示すことができます。また、イベントビューアの [イベント] 列と [分類] 列に表示するアプリケーション定義の eventId パラメータおよび category パラメータも指定できます。最後に、特定のイベントに追加情報を関連付ける必要がある場合は、イベントエントリにバイナリデータを付加することもできます。

EventLog クラスは、個別のイベントログとそのエントリへのアクセスを提供するだけではなく、すべてのイベントログのコレクションへのアクセスも提供します。 EventLog の静的 (Visual Basic では Shared) メンバを使用すると、ログの削除、ログリストの取得、ソースの作成または削除、特定のソースがコンピュータに既に存在するかどうかの確認などを行うことができます。

Windows 2000 には、アプリケーションログ、システムログ、セキュリティログの 3 つの既定のログがあります。Active Directory など、インストールされた他のアプリケーションやサービスでは追加のイベントログを使用できます。 EventLog を使用してカスタムイベントログを作成できます。カスタムイベントログはサーバーのイベントビューアで表示できます。

イベントのログはディスク容量やプロセッサ時間、その他のシステムリソースを消費します。このため、必要な情報だけをログすることが重要です。パフォーマンスの低下を避けるために、イベントログの呼び出しはメインのコードパスではなくエラーパスに配置することをお勧めします。

EventLog のインスタンスのプロパティの初期値の一覧については、 EventLog コンストラクタのトピックを参照してください。

使用例

[Visual Basic, C#, C++] ローカルコンピュータ上のイベントログ "MyNewLog" にエントリを書き込み、ソースが存在しない場合はソース "MySource" を作成する例を次に示します。

[Visual Basic, C#, C++] メモコード内でイベントソースを作成する必要はありません。 Source プロパティで設定したソースが存在しない場合、 WriteEntry メソッドは、イベントログに書き込む前に、そのソースを作成します。

 
Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub 'Main 
End Class 'MySample

[C#] 
using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){
    
        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource")){
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatingEventSource");
        }
                
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";
        
        // Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.");
        
    }
}
   

[C++] 
#using <mscorlib.dll>
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;

int main(){

    // Create the source, if it does not already exist.
    if(!EventLog::SourceExists(S"MySource")){
        EventLog::CreateEventSource(S"MySource", S"MyNewLog");
        Console::WriteLine(S"CreatingEventSource");
    }

    // Create an EventLog instance and assign its source.
    EventLog* myLog = new EventLog();
    myLog->Source = S"MySource";

    // Write an informational entry to the event log.    
    myLog->WriteEntry(S"Writing to event log.");

}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Diagnostics

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

アセンブリ: System (System.dll 内)

.NET Framework セキュリティ:

SecurityPermission (完全信頼を指定して EventLog のメンバを呼び出すためのアクセス許可) PermissionState.Unrestricted (関連する列挙体)

参照

EventLog メンバ | System.Diagnostics 名前空間 | EventLogEntry | EntryWrittenEventArgs | ServiceBase

EventLog クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース