EventLogTraceListener.TraceEvent メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.EventLog.dll

パッケージ:

System.Diagnostics.EventLog v8.0.0

イベント ログにトレース情報を書き込みます。

オーバーロード

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	トレース情報、メッセージ、およびイベント情報をイベント ログに書き込みます。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	トレース情報、オブジェクトの書式付き配列、およびイベント情報をイベント ログに書き込みます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

ソース:

EventLogTraceListener.cs

トレース情報、メッセージ、およびイベント情報をイベント ログに書き込みます。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

パラメーター

eventCache

TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。

source

String

出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。

severity

TraceEventType

トレースを発生させたイベントの種類を指定する列挙値の 1 つ。

id

Int32

イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。

message

String

トレース メッセージ。

属性

ComVisibleAttribute

例外

ArgumentException

source が指定されていません。

- または -

ログ エントリの文字列の長さが 32,766 文字を超えています。

注釈

重要

メソッドは TraceEvent 、アプリケーション コードによって呼び出されるものではありません。 これらのメソッドは、トレース データを Debug書き込む、、 Trace、 TraceSource クラスのメソッドによって呼び出されます。

メソッドは TraceEvent 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。

eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryType にEventLogEntryType相当します。 EventInstanceは、 メソッドを使用してデータをmessage使用してイベント ログにWriteEvent書き込まれます。

注意

パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

ソース:

EventLogTraceListener.cs

トレース情報、オブジェクトの書式付き配列、およびイベント情報をイベント ログに書き込みます。

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

パラメーター

eventCache

TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。

source

String

出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。

severity

TraceEventType

トレースを発生させたイベントの種類を指定する列挙値の 1 つ。

id

Int32

イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。

format

String

0 個以上の書式項目を格納している書式指定文字列。args 配列内のオブジェクトに対応します。

args

Object[]

0 個以上の書式設定対象オブジェクトを含んだ object 配列。

属性

ComVisibleAttribute

例外

ArgumentException

source が指定されていません。

- または -

ログ エントリの文字列の長さが 32,766 文字を超えています。

注釈

重要

メソッドは TraceEvent 、アプリケーション コードによって呼び出されるものではありません。 これらのメソッドは、トレース データを Debug書き込む、、 Trace、 TraceSource クラスのメソッドによって呼び出されます。

メソッドは TraceEvent 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。

eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryType にEventLogEntryType相当します。 はEventInstance、 パラメーターと args パラメーターから取得したメッセージと共に、 メソッドをWriteEvent使用してイベント ログにformat書き込まれます。 argsオブジェクト配列は、 メソッドを使用してFormat文字列に変換され、文字列とargs配列をformat渡して、イベント ログのメッセージとして文字列を書式設定します。

注意

パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。