TraceSource.TraceEvent Methode

Definition

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener in der Listeners-Auflistung.Writes a trace event message to the trace listeners in the Listeners collection.

Überlädt

TraceEvent(TraceEventType, Int32)

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp und Ereignisbezeichner verwendet.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type and event identifier.

TraceEvent(TraceEventType, Int32, String)

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und die angegebene Meldung verwendet.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type, event identifier, and message.

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

Schreibt ein Ablaufverfolgungsereignis in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner sowie das angegebene Argumentarray und Format verwendet.Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.

TraceEvent(TraceEventType, Int32)

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp und Ereignisbezeichner verwendet.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type and event identifier.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parameter

eventType
TraceEventType

Einer der Enumerationswerte, der den Ereignistyp der Ablaufverfolgungsdaten angibt.One of the enumeration values that specifies the event type of the trace data.

id
Int32

Ein numerischer Bezeichner für das Ereignis.A numeric identifier for the event.

Attribute

Ausnahmen

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.An attempt was made to trace an event during finalization.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der- TraceEvent(TraceEventType, Int32) Methode, um ein Ablauf Verfolgungs Ereignis an die Listener zu übergeben.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird TraceSource .This code example is part of a larger example provided for the TraceSource class.

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Hinweise

Die- TraceEvent Methode dient zum Verfolgen von Ereignissen, die von-Tools automatisch verarbeitet werden können.The TraceEvent method is intended to trace events that can be processed automatically by tools. Beispielsweise kann ein Überwachungs Tool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle verfolgt wird.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

Die- TraceEvent Methode ruft die- ShouldTrace Methode des SourceSwitch von der-Eigenschaft zurückgegebenen-Objekts auf Switch .The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Wenn ShouldTrace zurückgibt true , TraceEvent Ruft die entsprechende- TraceEvent Methode für jeden Listener auf.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. Andernfalls wird zurückgegeben, ohne dass die Listener- TraceEvent Methoden aufgerufen werden.Otherwise, TraceEvent returns without calling the listeners' methods.

Der Ablauf Verfolgungs Inhalt ist Listener-spezifisch.The trace content is listener specific. Wenn die-Methode von der Listenerimplementierung nicht überschrieben wird, ist die Standardausgabe der Name der Ablauf Verfolgungs Quelle, ihre numerische Identität und der Ereignistyp.If the method is not overridden by the listener implementation, the default output is the name of the trace source, its numeric identity, and the event type. Zusätzlicher Ablauf Verfolgungs Inhalt ist abhängig vom- TraceOutputOptions Eigenschafts Wert des Listener.Additional trace content is dependent upon the listener's TraceOutputOptions property value.

Hinweis

Das- EventLogTraceListener Objekt ist auf einen maximalen id Wert von 65.535 beschränkt.The EventLogTraceListener object is limited to a maximum id value of 65,535. Wenn der id angegebene Wert größer als 65.535 ist, EventLogTraceListener verwendet die 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener uses 65,535.

TraceEvent(TraceEventType, Int32, String)

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und die angegebene Meldung verwendet.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type, event identifier, and message.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parameter

eventType
TraceEventType

Einer der Enumerationswerte, der den Ereignistyp der Ablaufverfolgungsdaten angibt.One of the enumeration values that specifies the event type of the trace data.

id
Int32

Ein numerischer Bezeichner für das Ereignis.A numeric identifier for the event.

message
String

Die zu schreibende Ablaufverfolgungsmeldung.The trace message to write.

Attribute

Ausnahmen

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.An attempt was made to trace an event during finalization.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der- TraceEvent(TraceEventType, Int32) Methode, um ein Ablauf Verfolgungs Ereignis an die Listener zu übergeben.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird TraceSource .This code example is part of a larger example provided for the TraceSource class.

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Hinweise

Die- TraceEvent Methode dient zum Verfolgen von Ereignissen, die von-Tools automatisch verarbeitet werden können.The TraceEvent method is intended to trace events that can be processed automatically by tools. Beispielsweise kann ein Überwachungs Tool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle verfolgt wird.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

Die- TraceEvent Methode ruft die- ShouldTrace Methode des SourceSwitch von der-Eigenschaft zurückgegebenen-Objekts auf Switch .The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Wenn ShouldTrace zurückgibt true , TraceEvent Ruft die entsprechende- TraceEvent Methode für jeden Listener auf.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. Andernfalls wird zurückgegeben, ohne dass die Listener- TraceEvent Methoden aufgerufen werden.Otherwise, TraceEvent returns without calling the listeners' methods.

Der Ablauf Verfolgungs Inhalt ist Listener-spezifisch.The trace content is listener specific. Wenn die Methode nicht durch die Listenerimplementierung überschrieben wird, ist die Standardausgabe der Name der Ablauf Verfolgungs Quelle, die numerische Identität, der Ereignistyp und die Nachricht.If the method is not overridden by the listener implementation, the default output is the name of the trace source, its numeric identity, the event type, and the message. Zusätzlicher Ablauf Verfolgungs Inhalt ist abhängig vom- TraceOutputOptions Eigenschafts Wert des Listener.Additional trace content is dependent upon the listener's TraceOutputOptions property value.

Hinweis

Das- EventLogTraceListener Objekt ist auf einen maximalen id Wert von 65.535 beschränkt.The EventLogTraceListener object is limited to a maximum id value of 65,535. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das- EventLogTraceListener Objekt 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

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

Schreibt ein Ablaufverfolgungsereignis in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner sowie das angegebene Argumentarray und Format verwendet.Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parameter

eventType
TraceEventType

Einer der Enumerationswerte, der den Ereignistyp der Ablaufverfolgungsdaten angibt.One of the enumeration values that specifies the event type of the trace data.

id
Int32

Ein numerischer Bezeichner für das Ereignis.A numeric identifier for the event.

format
String

Eine zusammengesetzte Formatzeichenfolge mit Text, der 0 oder mehr Formatelemente enthält, die Objekten im Array args entsprechen.A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the args array.

args
Object[]

Ein object-Array mit 0 oder mehr zu formatierenden Objekten.An object array containing zero or more objects to format.

Attribute

Ausnahmen

format ist null.format is null.

format ist ungültig.format is invalid.

- oder --or- Die Zahl, die ein zu formatierendes Argument angibt, ist kleiner als 0 (null) bzw. größer oder gleich der Anzahl der angegebenen zu formatierenden Objekte.The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format.

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.An attempt was made to trace an event during finalization.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der- TraceEvent(TraceEventType, Int32) Methode, um ein Ablauf Verfolgungs Ereignis an die Listener zu übergeben.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird TraceSource .This code example is part of a larger example provided for the TraceSource class.

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Hinweise

Weitere Informationen zum- format Parameter finden Sie unter kombinierte Formatierung.For more information about the format parameter, see Composite Formatting.

Die- TraceEvent Methode dient zum Verfolgen von Ereignissen, die von-Tools automatisch verarbeitet werden können.The TraceEvent method is intended to trace events that can be processed automatically by tools. Beispielsweise kann ein Überwachungs Tool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle verfolgt wird.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

Die- TraceEvent Methode ruft die- ShouldTrace Methode des SourceSwitch von der-Eigenschaft zurückgegebenen-Objekts auf Switch .The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Wenn ShouldTrace zurückgibt true , TraceEvent Ruft die entsprechende- TraceEvent Methode für jeden Listener auf.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. Andernfalls wird zurückgegeben, ohne dass die Listener- TraceEvent Methoden aufgerufen werden.Otherwise, TraceEvent returns without calling the listeners' methods.

Der Ablauf Verfolgungs Inhalt ist Listener-spezifisch.The trace content is listener specific. Die Standard TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) Methode schreibt den Quellnamen, den Ereignistyp und die numerische Identität in den Ablauf Verfolgungs Header, ruft dann die- String.Format(IFormatProvider, String, Object[]) Methode auf, übergibt die format Zeichenfolge und das args Array und verwendet die- CultureInfo.InvariantCulture Eigenschaft, um die Zeichenfolge als Nachrichten Ausgabe zu formatieren.The default TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) method writes the source name, event type, and numeric identity in the trace header, then calls the String.Format(IFormatProvider, String, Object[]) method, passing the format string and args array and using the CultureInfo.InvariantCulture property to format the string as the message output.

Hinweis

Das- EventLogTraceListener Objekt ist auf einen maximalen id Wert von 65.535 beschränkt.The EventLogTraceListener object is limited to a maximum id value of 65,535. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das- EventLogTraceListener Objekt 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

Weitere Informationen

Gilt für: