EventLogTraceListener クラス

トレース出力またはデバッグ出力を EventLog に転送する簡単なリスナを提供します。

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

System.Object
   System.MarshalByRefObject
      System.Diagnostics.TraceListener
         System.Diagnostics.EventLogTraceListener

NotInheritable Public Class EventLogTraceListener
   Inherits TraceListener
[C#]
public sealed class EventLogTraceListener : TraceListener
[C++]
public __gc __sealed class EventLogTraceListener : public
   TraceListener
[JScript]
public class EventLogTraceListener extends TraceListener

スレッドセーフ

この型は、マルチスレッド操作に対して安全です。

解説

トレース出力またはデバッグの出力を EventLog にリダイレクトするために、この EventLogTraceListener のインスタンスを Debug.Listeners コレクションまたは Trace.Listeners コレクションに追加できます。

このクラスは、トレース出力またはデバッグ出力を受信するイベント ログを取得または設定するための EventLog プロパティと、 EventLogTraceListener の名前を保持するための Name プロパティを提供します。

Close メソッドは、イベント ログを終了して、トレース出力またはデバッグ出力を受信しないようにします。メッセージは、 Write メソッドおよび WriteLine メソッドによってイベント ログに書き込まれます。

使用例

[Visual Basic, C#, C++] イベント ログに出力するトレース リスナを作成する例を次に示します。まず、 myEventLog というイベント ログが作成されます。次に、 myEventLog を使用する新しい EventLogTraceListener が作成されます。さらに、 myTraceListener が Trace.Listeners コレクションに追加されます。最後に、行が Listeners オブジェクトに出力されます。

 
Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub 'Main

[C#] 
public static void Main(string[] args) {

    // Create a trace listener for the event log.
    EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
 
    // Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener);
 
    // Write output to the event log.
    Trace.WriteLine("Test output");
 }
 

[C++] 
int main() {

    // Create a trace listener for the event log.
    EventLogTraceListener* myTraceListener = new EventLogTraceListener(S"myEventLogSource");

    // Add the event log trace listener to the collection.
    Trace::Listeners->Add(myTraceListener);

    // Write output to the event log.
    Trace::WriteLine(S"Test output");
}

[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 内)

参照

EventLogTraceListener メンバ | System.Diagnostics 名前空間 | TraceListener | DefaultTraceListener | TextWriterTraceListener | EventLog | Stream | TextWriter | Debug | Trace