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

EventLogTraceListener コンストラクタ ()

トレース リスナを指定せずに、EventLogTraceListener クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New EventLogTraceListener

C#

public EventLogTraceListener ()

C++

public:
EventLogTraceListener ()

J#

public EventLogTraceListener ()

JScript

public function 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 クラス
EventLogTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace

EventLogTraceListener コンストラクタ

EventLogTraceListener クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
EventLogTraceListener ()	トレース リスナを指定せずに、EventLogTraceListener クラスの新しいインスタンスを初期化します。
EventLogTraceListener (EventLog)	イベント ログを指定して、EventLogTraceListener クラスの新しいインスタンスを初期化します。
EventLogTraceListener (String)	ソースを指定して、EventLogTraceListener クラスの新しいインスタンスを初期化します。

参照

関連項目

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

EventLogTraceListener コンストラクタ (EventLog)

イベント ログを指定して、EventLogTraceListener クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    eventLog As EventLog _
)

Visual Basic (使用法)

Dim eventLog As EventLog

Dim instance As New EventLogTraceListener(eventLog)

C#

public EventLogTraceListener (
    EventLog eventLog
)

C++

public:
EventLogTraceListener (
    EventLog^ eventLog
)

J#

public EventLogTraceListener (
    EventLog eventLog
)

JScript

public function EventLogTraceListener (
    eventLog : EventLog
)

パラメータ

eventLog

書き込み先となるイベント ログを指定する EventLog。

プラットフォーム

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 クラス
EventLogTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace

EventLogTraceListener コンストラクタ (String)

ソースを指定して、EventLogTraceListener クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    source As String _
)

Visual Basic (使用法)

Dim source As String

Dim instance As New EventLogTraceListener(source)

C#

public EventLogTraceListener (
    string source
)

C++

public:
EventLogTraceListener (
    String^ source
)

J#

public EventLogTraceListener (
    String source
)

JScript

public function EventLogTraceListener (
    source : String
)

パラメータ

source

既存のイベント ログ ソースの名前。

プラットフォーム

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 クラス
EventLogTraceListener メンバ
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace

EventLogTraceListener プロパティ

パブリック プロパティ

	名前	説明
	Attributes	アプリケーション構成ファイルに定義されているカスタム トレース リスナ属性を取得します。 ( TraceListener から継承されます。)
	EventLog	書き込み先となるイベント ログを取得または設定します。
	Filter	トレース リスナのトレース フィルタを取得および設定します。 ( TraceListener から継承されます。)
	IndentLevel	インデントのレベルを取得または設定します。 ( TraceListener から継承されます。)
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。 ( TraceListener から継承されます。)
	IsThreadSafe	トレース リスナがスレッド セーフかどうかを示す値を取得します。 ( TraceListener から継承されます。)
	Name	オーバーライドされます。 この EventLogTraceListener の名前を取得または設定します。
	TraceOutputOptions	トレース出力オプションを取得または設定します。 ( TraceListener から継承されます。)

参照

関連項目

EventLogTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace

EventLogTraceListener メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	オーバーライドされます。 イベント ログを終了して、トレース出力またはデバッグ出力を受信しないようにします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	TraceListener によって使用されているすべてのリソースを解放します。 ( TraceListener から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Fail	オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。 ( TraceListener から継承されます。)
	Flush	派生クラスによってオーバーライドされるときに、出力バッファをフラッシュします。 ( TraceListener から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	TraceData	オーバーロードされます。 オーバーライドされます。 イベント ログにトレース データを書き込みます。
	TraceEvent	オーバーロードされます。 イベント ログにイベント トレース情報を書き込みます。
	TraceTransfer	トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。 ( TraceListener から継承されます。)
	Write	オーバーロードされます。 このインスタンスのイベント ログにメッセージを書き込みます。
	WriteLine	オーバーロードされます。 このインスタンスのイベント ログにメッセージを書き込みます。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

EventLogTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace

EventLogTraceListener メンバ

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

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

パブリック コンストラクタ

	名前	説明
	EventLogTraceListener	オーバーロードされます。 EventLogTraceListener クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Attributes	アプリケーション構成ファイルに定義されているカスタム トレース リスナ属性を取得します。(TraceListener から継承されます。)
	EventLog	書き込み先となるイベント ログを取得または設定します。
	Filter	トレース リスナのトレース フィルタを取得および設定します。(TraceListener から継承されます。)
	IndentLevel	インデントのレベルを取得または設定します。(TraceListener から継承されます。)
	IndentSize	1 つのインデントに含まれる空白の数を取得または設定します。(TraceListener から継承されます。)
	IsThreadSafe	トレース リスナがスレッド セーフかどうかを示す値を取得します。 (TraceListener から継承されます。)
	Name	オーバーライドされます。 この EventLogTraceListener の名前を取得または設定します。
	TraceOutputOptions	トレース出力オプションを取得または設定します。(TraceListener から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	オーバーライドされます。 イベント ログを終了して、トレース出力またはデバッグ出力を受信しないようにします。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	TraceListener によって使用されているすべてのリソースを解放します。 (TraceListener から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Fail	オーバーロードされます。 TraceListener クラスの実装時に、作成したリスナにエラー メッセージを出力します。 (TraceListener から継承されます。)
	Flush	派生クラスによってオーバーライドされるときに、出力バッファをフラッシュします。 (TraceListener から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	TraceData	オーバーロードされます。 オーバーライドされます。 イベント ログにトレース データを書き込みます。
	TraceEvent	オーバーロードされます。 イベント ログにイベント トレース情報を書き込みます。
	TraceTransfer	トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナ固有の出力に書き込みます。 (TraceListener から継承されます。)
	Write	オーバーロードされます。 このインスタンスのイベント ログにメッセージを書き込みます。
	WriteLine	オーバーロードされます。 このインスタンスのイベント ログにメッセージを書き込みます。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)

参照

関連項目

EventLogTraceListener クラス
System.Diagnostics 名前空間
TraceListener
DefaultTraceListener クラス
TextWriterTraceListener
EventLog クラス
Stream
TextWriter
Debug クラス
Trace