Freigeben über


TraceSource.TraceEvent Methode

Definition

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener in der Listeners-Auflistung.

Überlädt

TraceEvent(TraceEventType, Int32)

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp und Ereignisbezeichner verwendet.

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.

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.

TraceEvent(TraceEventType, Int32)

Quelle:
TraceSource.cs
Quelle:
TraceSource.cs
Quelle:
TraceSource.cs

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp und Ereignisbezeichner verwendet.

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

id
Int32

Ein numerischer Bezeichner für das Ereignis.

Attribute

Ausnahmen

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der TraceEvent(TraceEventType, Int32) -Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener veranschaulicht. 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 der Nachverfolgung von Ereignissen, die von Tools automatisch 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ückgibt true, TraceEvent ruft die entsprechende TraceEvent Methode jedes Listeners auf. Andernfalls wird zurückgegeben, TraceEvent ohne die Methoden der Listener aufzurufen.

Der Ablaufverfolgungsinhalt ist listenerspezifisch. Wenn die Methode nicht von der Listenerimplementierung überschrieben wird, ist die Standardausgabe der Name der Ablaufverfolgungsquelle, deren numerische Identität und der Ereignistyp. 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, EventLogTraceListener verwendet 65.535.

Gilt für:

TraceEvent(TraceEventType, Int32, String)

Quelle:
TraceSource.cs
Quelle:
TraceSource.cs
Quelle:
TraceSource.cs

Schreibt eine Meldung eines Ablaufverfolgungsereignisses in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner und die angegebene Meldung verwendet.

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")]
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, der den Ereignistyp der Ablaufverfolgungsdaten angibt.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Die zu schreibende Ablaufverfolgungsmeldung.

Attribute

Ausnahmen

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der TraceEvent(TraceEventType, Int32) -Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener veranschaulicht. 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 der Nachverfolgung von Ereignissen, die von Tools automatisch 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ückgibt true, TraceEvent ruft die entsprechende TraceEvent Methode jedes Listeners auf. Andernfalls wird zurückgegeben, TraceEvent ohne die Methoden der Listener aufzurufen.

Der Ablaufverfolgungsinhalt ist listenerspezifisch. Wenn die Methode nicht von der Listenerimplementierung überschrieben wird, ist die Standardausgabe der Name der Ablaufverfolgungsquelle, deren numerische Identität, der Ereignistyp und die Meldung. 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.

Gilt für:

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

Quelle:
TraceSource.cs
Quelle:
TraceSource.cs
Quelle:
TraceSource.cs

Schreibt ein Ablaufverfolgungsereignis in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene Ereignistyp, der Ereignisbezeichner sowie das angegebene Argumentarray und Format verwendet.

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")]
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);
[<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.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

format
String

Eine zusammengesetzte Formatzeichenfolge mit Text, der 0 oder mehr Formatelemente enthält, die Objekten im Array args entsprechen.

args
Object[]

Ein object-Array mit 0 oder mehr zu formatierenden Objekten.

Attribute

Ausnahmen

format ist null.

format ist ungültig.

- oder -

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.

Es wurde versucht, während des Abschlusses ein Ereignis nachzuverfolgen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der TraceEvent(TraceEventType, Int32) -Methode zum Übergeben eines Ablaufverfolgungsereignisses an die Listener veranschaulicht. 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 der Nachverfolgung von Ereignissen, die von Tools automatisch 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ückgibt true, TraceEvent ruft die entsprechende TraceEvent Methode jedes Listeners auf. Andernfalls wird zurückgegeben, TraceEvent ohne die Methoden der Listener aufzurufen.

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

Gilt für: