EventLogTraceListener.TraceEvent Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

Zapíše informace o trasování událostí do protokolu událostí.

Přetížení

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše informace o trasování, zprávu a informace o událostech do protokolu událostí.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapíše trasovací informace, formátované pole objektů a informace o událostech do protokolu událostí.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Zdroj:

EventLogTraceListener.cs

Zapíše informace o trasování, zprávu a informace o událostech do protokolu událostí.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

Parametry

eventCache

TraceEventCache

Objekt, který obsahuje aktuální ID procesu, ID vlákna a informace o trasování zásobníku.

source

String

Název použitý k identifikaci výstupu; obvykle název aplikace, která vygenerovala událost trasování.

severity

TraceEventType

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

id

Int32

Číselný identifikátor události. Kombinace source a id jedinečně identifikuje událost.

message

String

Zpráva trasování.

Atributy

ComVisibleAttribute

Výjimky

ArgumentException

source není zadán.

-nebo-

Řetězec záznamu protokolu je delší než 32 766 znaků.

Poznámky

Důležité

Metody TraceEvent nejsou určeny k vyvolání kódem aplikace. Tyto metody jsou volána metodami Debugtříd , Tracea TraceSource pro zápis dat trasování.

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

Parametry eventCache a source se používají k určení, jestli má být událost trasována. idse používá k vytvoření EventInstance objektu EventLogEntryType a TraceEventType hodnota se rovná vlastnosti .EntryType Protokol EventInstance se zapíše do protokolu událostí s message daty pomocí WriteEvent metody .

Poznámka

Maximální hodnota parametru id je 65 535. id Pokud je zadaná hodnota větší než 65 535, použije se maximální hodnota.

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

Zdroj:

EventLogTraceListener.cs

Zapíše trasovací informace, formátované pole objektů a informace o událostech do protokolu událostí.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametry

eventCache

TraceEventCache

Objekt, který obsahuje aktuální ID procesu, ID vlákna a informace o trasování zásobníku.

source

String

Název použitý k identifikaci výstupu; obvykle název aplikace, která vygenerovala událost trasování.

severity

TraceEventType

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

id

Int32

Číselný identifikátor události. Kombinace source a id jedinečně identifikuje událost.

format

String

Formátovací řetězec, který obsahuje nula nebo více položek 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

ComVisibleAttribute

Výjimky

ArgumentException

source není zadán.

-nebo-

Řetězec záznamu protokolu je delší než 32 766 znaků.

Poznámky

Důležité

Metody TraceEvent nejsou určeny k vyvolání kódem aplikace. Tyto metody jsou volána metodami Debugtříd , Tracea TraceSource pro zápis dat trasování.

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

Parametry eventCache a source se používají k určení, jestli má být událost trasována. idse používá k vytvoření EventInstance objektu EventLogEntryType a TraceEventType hodnota se rovná vlastnosti .EntryType Protokol EventInstance se zapíše do protokolu událostí pomocí WriteEvent metody se zprávou získanou format z parametrů a args . Pole args objektů se převede na řetězec pomocí Format metody a předá format řetězec a args pole, aby se řetězec naformátoval jako zpráva pro protokol událostí.

Poznámka

Maximální hodnota parametru id je 65 535. id Pokud je zadaná hodnota větší než 65 535, použije se maximální hodnota.