TraceSource.TraceEvent Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TraceSource.dll

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

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

ConditionalAttribute

Výjimky

ObjectDisposedException

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.

TraceEvent(TraceEventType, Int32, String)

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

ConditionalAttribute

Výjimky

ObjectDisposedException

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.

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

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

ConditionalAttribute

Výjimky

ArgumentNullException

format je null.

FormatException

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.

ObjectDisposedException

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é

• Složené formátování
• Standardní řetězce pro formátování čísel
• Vlastní řetězce číselného formátu
• Standardní řetězce formátu DateTime
• Vlastní řetězce formátu DateTime
• Řetězce formátu výčtu
• Typy formátování v .NET