EventLogTraceListener クラス

.NET Framework クラス ライブラリ リファレンス

EventLogTraceListener クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 EventLogTraceListener
    Inherits TraceListener

Visual Basic (使用法)

Dim instance As EventLogTraceListener

C#

public sealed class EventLogTraceListener :
 TraceListener

C++

public ref class EventLogTraceListener sealed
 : public TraceListener

J#

public final class EventLogTraceListener extends
 TraceListener

JScript

public final class EventLogTraceListener extends
 TraceListener

解説

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

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

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

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

メモ
大量のデータがイベント ログに書き込まれないようにするために、EventLogTraceListener は TraceOutputOptions プロパティによって指定されたオプションのトレース データを出力しません。

Topic	Location
チュートリアル : ASP.NET トレースと System.Diagnostics トレースの統合	ASP .NET Web アプリケーションの作成

使用例

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

Visual Basic

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 = gcnew 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" );
}

J#

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.get_Listeners().Add(myTraceListener);

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

継承階層

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

スレッド セーフ

この型は、スレッド セーフです。

プラットフォーム

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

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
EventLogTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace