EventLogTraceListener クラス

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.EventLog.dll

パッケージ:

System.Diagnostics.EventLog v8.0.0

ソース:

EventLogTraceListener.cs

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

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener

public sealed class EventLogTraceListener : System.Diagnostics.TraceListener

type EventLogTraceListener = class
    inherit TraceListener

Public NotInheritable Class EventLogTraceListener
Inherits TraceListener

継承

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

例

次の例では、出力をイベント ログに送信するトレース リスナーを作成します。 最初に、ソース myEventLogSourceを使用する新しい EventLogTraceListener を作成します。 次に、 myTraceListener がコレクションに Trace.Listeners 追加されます。 最後に、出力行を オブジェクトに Listeners 送信します。

int main()
{
   #if defined(TRACE)
   
   // 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" );
   
   #endif
}

// 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");

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

注釈

このEventLogTraceListenerのインスタンスを 、Trace.Listeners、または TraceSource.Listeners コレクションにDebug.Listeners追加して、トレースまたはデバッグからの出力を にEventLog送信できます。 コードに インスタンスを追加することも、.NET Framework アプリの場合は、アプリケーション構成ファイルで指定することもできます。

.NET Frameworkアプリケーション構成ファイルを使用して をEventLogTraceListener追加するには、アプリケーションの名前に対応するファイルを編集します。 このファイルで、型の要素を System.Diagnostics.EventLogTraceListener 挿入します。 次の例では、 という名前myListenerの EventLogTraceListener オブジェクトを コレクションにTrace.Listeners追加します。 パラメーターは initializeData 、コンストラクターに渡されるイベント ログ ソースの名前を EventLogTraceListener(String) 指定します。

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

注意

Sourceインスタンスに関連付けられているイベント ログの EventLogTraceListener が存在しない場合は、新しいイベント ソースが作成されます。 Windows Vista、Windows XP Professional、または Windows Server 2003 でイベント ソースを作成するには、管理者特権が必要です。

この要件の理由は、セキュリティを含むすべてのイベント ログを検索して、イベント ソースが一意かどうかを判断する必要があるということです。 Windows Vista では、ユーザーはセキュリティ ログにアクセスするアクセス許可を持っていません。したがって、 SecurityException がスローされます。

Windows Vista では、ユーザー アカウント制御 (UAC: User Account Control) でユーザーの権限が決定されます。 ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。 既定では、ユーザーは標準ユーザー ロールに所属します。 セキュリティ ログにアクセスするコードを実行するには、まず、特権を標準ユーザーから管理者に昇格させる必要があります。 この操作は、アプリケーションの起動時にアプリケーション アイコンを右クリックし、管理者として実行することを指定して行うことができます。

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

メソッドは Close イベント ログを閉じて、トレースまたはデバッグ出力を受信しなくなります。 メソッドと WriteLine メソッドはWrite、イベント ログにメッセージを書き込みます。

注意

イベント ログに大量のデータを書き込む可能性を回避するために、 EventLogTraceListener プロパティで指定されたオプションのトレース データは TraceOutputOptions 出力されません。

コンストラクター

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

プロパティ

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

メソッド

Close()	イベント ログを終了して、トレース出力またはデバッグ出力を受信しないようにします。
CreateObjRef(Type)	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	TraceListener によって使用されているすべてのリソースを解放します。 (継承元 TraceListener)
Dispose(Boolean)	TraceListener によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 TraceListener)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Fail(String)	TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージを出力します。 (継承元 TraceListener)
Fail(String, String)	TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージと詳細エラー メッセージを出力します。 (継承元 TraceListener)
Flush()	派生クラスでオーバーライドされた場合、出力バッファーをフラッシュします。 (継承元 TraceListener)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
GetSupportedAttributes()	トレース リスナーによってサポートされるカスタム属性を取得します。 (継承元 TraceListener)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	トレース情報、データ オブジェクト、およびイベント情報をイベント ログに書き込みます。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	トレース情報、データ オブジェクトの配列、およびイベント情報をイベント ログに書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	トレース情報およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	トレース情報、メッセージ、およびイベント情報をイベント ログに書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	トレース情報、オブジェクトの書式付き配列、およびイベント情報をイベント ログに書き込みます。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナー固有の出力に書き込みます。 (継承元 TraceListener)
Write(Object)	オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装した時に作成したリスナーに書き込みます。 (継承元 TraceListener)
Write(Object, String)	カテゴリ名と、オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装するときに作成したリスナーに書き込みます。 (継承元 TraceListener)
Write(String)	このインスタンスのイベント ログにメッセージを書き込みます。
Write(String, String)	TraceListener クラスを実装した時に作成したリスナーにカテゴリ名とメッセージを書き込みます。 (継承元 TraceListener)
WriteIndent()	このクラスの実装時に作成したリスナーにインデントを書き込み、NeedIndent プロパティを false にリセットします。 (継承元 TraceListener)
WriteLine(Object)	TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(Object, String)	TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(String)	このインスタンスのイベント ログにメッセージを書き込みます。
WriteLine(String, String)	TraceListener クラスの実装時に作成したリスナーにカテゴリ名、メッセージ、および行終端記号を書き込みます。 (継承元 TraceListener)

スレッド セーフ

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

こちらもご覧ください

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace