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 argumentů a formátu. |
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) metoda předat trasovací události posluchačům. Tento příklad kódu je součástí většího příkladu poskytnutého pro třídu TraceSource.
ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)
Poznámky
Metoda TraceEvent je určená ke sledování událostí, které lze automaticky zpracovat nástroji. Například monitorovací nástroj může správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.
Metoda TraceEvent volá ShouldTrace metodu objektu SourceSwitch vráceného vlastností Switch. Pokud ShouldTrace vrátí true, TraceEvent volá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném případě TraceEvent vrátí bez volání metod naslouchacího procesu.
Obsah trasování je specifický pro naslouchací proces. Pokud metoda není přepsána implementací naslouchacího procesu, výchozí výstup je název zdroje trasování, jeho číselná identita a typ události. Další obsah trasování závisí na hodnotě vlastnosti TraceOutputOptions naslouchacího procesu.
Poznámka
Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. Pokud je zadaná hodnota id větší než 65 535, EventLogTraceListener použije 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) metoda předat trasovací události posluchačům. Tento příklad kódu je součástí většího příkladu poskytnutého pro třídu TraceSource.
// 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á ke sledování událostí, které lze automaticky zpracovat nástroji. Například monitorovací nástroj může správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.
Metoda TraceEvent volá ShouldTrace metodu objektu SourceSwitch vráceného vlastností Switch. Pokud ShouldTrace vrátí true, TraceEvent volá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném případě TraceEvent vrátí bez volání metod naslouchacího procesu.
Obsah trasování je specifický pro naslouchací proces. Pokud metoda není přepsána implementací naslouchacího procesu, výchozí výstup je název zdroje trasování, jeho číselná identita, typ události a zpráva. Další obsah trasování závisí na hodnotě vlastnosti TraceOutputOptions naslouchacího procesu.
Poznámka
Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. Pokud je zadaná hodnota id větší než 65 535, použije objekt EventLogTraceListener hodnotu 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 argumentů a formátu.
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 intermixovaný s nulovou nebo více položkami formátu, které odpovídají objektům v poli args.
- args
- Object[]
Pole object obsahující nula nebo více objektů k formátování.
- Atributy
Výjimky
format je null.
format je neplatný.
-nebo-
Číslo, které označuje argument pro formátování, je menší než nula nebo větší nebo roven počtu zadaných objektů k formátování.
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) metoda předat trasovací události posluchačům. Tento příklad kódu je součástí většího příkladu poskytnutého pro třídu TraceSource.
// 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 format naleznete v tématu složené formátování.
Metoda TraceEvent je určená ke sledování událostí, které lze automaticky zpracovat nástroji. Například monitorovací nástroj může správce upozornit, pokud je konkrétní událost trasována konkrétním zdrojem.
Metoda TraceEvent volá ShouldTrace metodu objektu SourceSwitch vráceného vlastností Switch. Pokud ShouldTrace vrátí true, TraceEvent volá odpovídající TraceEvent metodu každého naslouchacího procesu. V opačném případě TraceEvent vrátí bez volání metod naslouchacího procesu.
Obsah trasování je specifický pro naslouchací proces. Výchozí TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) metoda zapíše do hlavičky trasování název zdroje, typ události a číselnou identitu a potom zavolá metodu String.Format(IFormatProvider, String, Object[]), předá řetězec format a args pole a pomocí vlastnosti CultureInfo.InvariantCulture formátuje řetězec jako výstup zprávy.
Poznámka
Objekt EventLogTraceListener je omezen na maximální id hodnotu 65 535. Pokud je zadaná hodnota id větší než 65 535, použije objekt EventLogTraceListener hodnotu 65 535.
Viz také
- složené formátování
- standardní řetězce číselného formátu
- vlastních řetězců číselného formátu
- standardní řetězce formátu DateTime
- vlastní řetězce formátu DateTime
- řetězců formátu výčtu
- typy formátování v rozhraní .NET
