TraceSource.TraceEvent Methode

Definition

Namespace:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.TraceSource.dll

Schreibt eine Ablaufverfolgungsereignisnachricht in die Ablaufverfolgungslistener in der Listeners Auflistung.

Überlädt

Name	Beschreibung
TraceEvent(TraceEventType, Int32)	Schreibt eine Ablaufverfolgungsereignisnachricht in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps und ereignisbezeichners.
TraceEvent(TraceEventType, Int32, String)	Schreibt eine Ablaufverfolgungsereignisnachricht in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps, des Ereignisbezeichners und der Nachricht.
TraceEvent(TraceEventType, Int32, String, Object[])	Schreibt ein Ablaufverfolgungsereignis in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps, des Ereignisbezeichners und des Argumentarrays und -formats.

TraceEvent(TraceEventType, Int32)

Quelle:

TraceSource.cs

Schreibt eine Ablaufverfolgungsereignisnachricht in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps und ereignisbezeichners.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent(System.Diagnostics.TraceEventType eventType, int id);

[<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, die den Ereignistyp der Ablaufverfolgungsdaten angibt.

id

Int32

Ein numerischer Bezeichner für das Ereignis.

Attribute

ConditionalAttribute

Ausnahmen

ObjectDisposedException

Es wurde versucht, ein Ereignis während der Fertigstellung nachzuverfolgen.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TraceEvent(TraceEventType, Int32) Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource Klasse bereitgestellt wird.

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Hinweise

Die TraceEvent Methode dient zum Nachverfolgen von Ereignissen, die automatisch von Tools verarbeitet werden können. Beispielsweise kann ein Überwachungstool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle nachverfolgt wird.

Die TraceEvent Methode ruft die ShouldTrace Methode des Objekts auf, das SourceSwitch von der Switch Eigenschaft zurückgegeben wird. Wenn ShouldTrace zurückgegeben truewird, TraceEvent ruft die entsprechende TraceEvent Methode der einzelnen Listener auf. TraceEvent Andernfalls wird ohne Aufruf der Listenermethoden zurückgegeben.

Der Ablaufverfolgungsinhalt ist listenerspezifisch. Wenn die Methode nicht von der Listenerimplementierung außer Kraft gesetzt wird, ist die Standardausgabe der Name der Ablaufverfolgungsquelle, der numerischen Identität und des Ereignistyps. Zusätzliche Ablaufverfolgungsinhalte sind vom Eigenschaftswert des TraceOutputOptions Listeners abhängig.

Hinweis

Das EventLogTraceListener Objekt ist auf einen Maximalwert id von 65.535 beschränkt. Wenn der id angegebene Wert größer als 65.535 ist, verwendet der EventLogTraceListener Wert 65.535.

TraceEvent(TraceEventType, Int32, String)

Quelle:

TraceSource.cs

Schreibt eine Ablaufverfolgungsereignisnachricht in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps, des Ereignisbezeichners und der Nachricht.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent(System.Diagnostics.TraceEventType eventType, int id, string? message);

[<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, die den Ereignistyp der Ablaufverfolgungsdaten angibt.

id

Int32

Ein numerischer Bezeichner für das Ereignis.

message

String

Die zu schreibende Ablaufverfolgungsnachricht.

Attribute

ConditionalAttribute

Ausnahmen

ObjectDisposedException

Es wurde versucht, ein Ereignis während der Fertigstellung nachzuverfolgen.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TraceEvent(TraceEventType, Int32) Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource Klasse bereitgestellt wird.

// 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 Nachverfolgen von Ereignissen, die automatisch von Tools verarbeitet werden können. Beispielsweise kann ein Überwachungstool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle nachverfolgt wird.

Die TraceEvent Methode ruft die ShouldTrace Methode des Objekts auf, das SourceSwitch von der Switch Eigenschaft zurückgegeben wird. Wenn ShouldTrace zurückgegeben truewird, TraceEvent ruft die entsprechende TraceEvent Methode der einzelnen Listener auf. TraceEvent Andernfalls wird ohne Aufruf der Listenermethoden zurückgegeben.

Der Ablaufverfolgungsinhalt ist listenerspezifisch. Wenn die Methode nicht von der Listenerimplementierung außer Kraft gesetzt wird, ist die Standardausgabe der Name der Ablaufverfolgungsquelle, der numerischen Identität, des Ereignistyps und der Nachricht. Zusätzliche Ablaufverfolgungsinhalte sind vom Eigenschaftswert des TraceOutputOptions Listeners abhängig.

Hinweis

Das EventLogTraceListener Objekt ist auf einen Maximalwert id von 65.535 beschränkt. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das EventLogTraceListener Objekt 65.535.

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

Quelle:

TraceSource.cs

Schreibt ein Ablaufverfolgungsereignis in die Ablaufverfolgungslistener in der Listeners Auflistung mithilfe des angegebenen Ereignistyps, des Ereignisbezeichners und des Argumentarrays und -formats.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent(System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<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, die den Ereignistyp der Ablaufverfolgungsdaten angibt.

id

Int32

Ein numerischer Bezeichner für das Ereignis.

format

String

Eine zusammengesetzte Formatzeichenfolge, die Text enthält, der mit Null- oder mehr Formatelementen kombiniert wird, die Objekten im args Array entsprechen.

args

Object[]

Ein object Array, das null oder mehr Zu formatierende Objekte enthält.

Attribute

ConditionalAttribute

Ausnahmen

ArgumentNullException

format ist null.

FormatException

format ist ungültig.

- oder -

Die Zahl, die ein zu formatendes Argument angibt, ist kleiner als Null oder größer als oder gleich der Anzahl der angegebenen Objekte, die formatiert werden sollen.

ObjectDisposedException

Es wurde versucht, ein Ereignis während der Fertigstellung nachzuverfolgen.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TraceEvent(TraceEventType, Int32) Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource Klasse bereitgestellt wird.

// 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 "Zusammengesetzte Formatierung".

Die TraceEvent Methode dient zum Nachverfolgen von Ereignissen, die automatisch von Tools verarbeitet werden können. Beispielsweise kann ein Überwachungstool einen Administrator benachrichtigen, wenn ein bestimmtes Ereignis von einer bestimmten Quelle nachverfolgt wird.

Die TraceEvent Methode ruft die ShouldTrace Methode des Objekts auf, das SourceSwitch von der Switch Eigenschaft zurückgegeben wird. Wenn ShouldTrace zurückgegeben truewird, TraceEvent ruft die entsprechende TraceEvent Methode der einzelnen Listener auf. TraceEvent Andernfalls wird ohne Aufruf der Listenermethoden zurückgegeben.

Der Ablaufverfolgungsinhalt ist listenerspezifisch. Die Standardmethode TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) schreibt den Quellnamen, den Ereignistyp und die numerische Identität in den Ablaufverfolgungsheader, ruft dann die String.Format(IFormatProvider, String, Object[]) Methode auf, übergibt die Zeichenfolge und args das format Array und verwendet die CultureInfo.InvariantCulture Eigenschaft, um die Zeichenfolge als Nachrichtenausgabe zu formatieren.

Hinweis

Das EventLogTraceListener Objekt ist auf einen Maximalwert id von 65.535 beschränkt. Wenn der id angegebene Wert größer als 65.535 ist, verwendet das EventLogTraceListener Objekt 65.535.

Weitere Informationen

• Zusammengesetzte Formatierung
• Standardmäßige numerische Formatzeichenfolgen
• Benutzerdefinierte Zahlenformatzeichenfolgen
• Standard-DateTime-Formatzeichenfolgen
• Benutzerdefinierte DateTime-Formatzeichenfolgen
• Enumerationsformatzeichenfolgen
• Formatierungstypen in .NET