Sdílet prostřednictvím


TraceSource.TraceEvent Metoda

Definice

Zapíše zprávu události trasování do naslouchacích procesů trasování v kolekci Listeners .

Přetížení

TraceEvent(TraceEventType, Int32)

Zapíše zprávu události trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události a identifikátoru události.

TraceEvent(TraceEventType, Int32, String)

Zapíše zprávu události trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a zprávy.

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

Zapíše událost trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a pole a formátu argumentů.

TraceEvent(TraceEventType, Int32)

Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs

Zapíše zprávu události trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události a identifikátoru události.

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)

Parametry

eventType
TraceEventType

Jedna z hodnot výčtu, která určuje typ události dat trasování.

id
Int32

Číselný identifikátor události.

Atributy

Výjimky

Během finalizace došlo k pokusu o trasování události.

Příklady

Následující příklad kódu ukazuje použití TraceEvent(TraceEventType, Int32) metody k předání události trasování do naslouchacích procesů. Tento příklad kódu je součástí většího příkladu TraceSource pro třídu.

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

Poznámky

Metoda TraceEvent je určená k trasování událostí, které mohou být automaticky zpracovány nástroji. Monitorovací nástroj může například správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.

Metoda TraceEvent volá metodu ShouldTrace objektu SourceSwitch vrácenou Switch vlastností. Pokud ShouldTrace vrátí true, TraceEvent zavolá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném TraceEvent případě se vrátí bez volání metod naslouchacích procesů.

Obsah trasování je specifický pro naslouchací proces. Pokud metoda není přepsána implementací naslouchacího procesu, výchozím výstupem je název zdroje trasování, jeho číselná identita a typ události. Další obsah trasování závisí na hodnotě vlastnosti naslouchacího TraceOutputOptions procesu.

Poznámka

Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. id Pokud je zadaná hodnota větší než 65 535, EventLogTraceListener použije se hodnota 65 535.

Platí pro

TraceEvent(TraceEventType, Int32, String)

Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs

Zapíše zprávu události trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a zprávy.

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)

Parametry

eventType
TraceEventType

Jedna z hodnot výčtu, která určuje typ události dat trasování.

id
Int32

Číselný identifikátor události.

message
String

Zpráva trasování, která se má napsat.

Atributy

Výjimky

Během finalizace došlo k pokusu o trasování události.

Příklady

Následující příklad kódu ukazuje použití TraceEvent(TraceEventType, Int32) metody k předání události trasování do naslouchacích procesů. Tento příklad kódu je součástí většího příkladu TraceSource pro třídu.

// 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")

Poznámky

Metoda TraceEvent je určená k trasování událostí, které mohou být automaticky zpracovány nástroji. Monitorovací nástroj může například správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.

Metoda TraceEvent volá metodu ShouldTrace objektu SourceSwitch vrácenou Switch vlastností. Pokud ShouldTrace vrátí true, TraceEvent zavolá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném TraceEvent případě se vrátí bez volání metod naslouchacích procesů.

Obsah trasování je specifický pro naslouchací proces. Pokud metoda není přepsána implementací naslouchacího procesu, výchozím výstupem je název zdroje trasování, jeho číselná identita, typ události a zpráva. Další obsah trasování závisí na hodnotě vlastnosti naslouchacího TraceOutputOptions procesu.

Poznámka

Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. id Pokud je zadaná hodnota větší než 65 535, EventLogTraceListener objekt použije 65 535.

Platí pro

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

Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs
Zdroj:
TraceSource.cs

Zapíše událost trasování do naslouchacích procesů trasování v kolekci Listeners pomocí zadaného typu události, identifikátoru události a pole a formátu argumentů.

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())

Parametry

eventType
TraceEventType

Jedna z hodnot výčtu, která určuje typ události dat trasování.

id
Int32

Číselný identifikátor události.

format
String

Složený formátovací řetězec, který obsahuje text promíchaný s nulovým nebo více položkami formátu, které odpovídají objektům args v poli.

args
Object[]

Pole object obsahující nula nebo více objektů, které se mají formátovat.

Atributy

Výjimky

format je null.

Formát format je neplatný.

-nebo-

Číslo označující argument, který se má formátovat, je menší než nula nebo větší než nebo roven počtu zadaných objektů, které se mají formátovat.

Během finalizace došlo k pokusu o trasování události.

Příklady

Následující příklad kódu ukazuje použití TraceEvent(TraceEventType, Int32) metody k předání události trasování do naslouchacích procesů. Tento příklad kódu je součástí většího příkladu TraceSource pro třídu.

// 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")

Poznámky

Další informace o parametru najdete v format tématu Složené formátování.

Metoda TraceEvent je určená k trasování událostí, které mohou být automaticky zpracovány nástroji. Monitorovací nástroj může například správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.

Metoda TraceEvent volá metodu ShouldTrace objektu SourceSwitch vrácenou Switch vlastností. Pokud ShouldTrace vrátí true, TraceEvent zavolá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném TraceEvent případě se vrátí bez volání metod naslouchacích procesů.

Obsah trasování je specifický pro naslouchací proces. Výchozí TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) metoda zapíše název zdroje, typ události a číselnou identitu do hlavičky trasování, pak zavolá metodu String.Format(IFormatProvider, String, Object[]) , předá format řetězec a pole a args použije CultureInfo.InvariantCulture vlastnost k formátování řetězce jako výstupu zprávy.

Poznámka

Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. id Pokud je zadaná hodnota větší než 65 535, EventLogTraceListener objekt použije 65 535.

Viz také

Platí pro