TraceSource.TraceEvent Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitPublic 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 -> unitPublic 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[] -> unitPublic 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é
- 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
