TraceSource.TraceEvent Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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 -> unitPublic 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[] -> unitPublic 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
- Kombinierte Formatierung
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- Standardmäßige DateTime-Formatzeichenfolgen
- Benutzerdefinierte DateTime-Formatzeichenfolgen
- Enumeration Format Strings
- Formatieren von Typen in .NET
