EventLogTraceListener.TraceData Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

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

Přetížení

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapíše trasovací informace, datový objekt a informace o událostech do protokolu událostí.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje trasovací informace, pole datových objektů a informace o událostech do protokolu událostí.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Zdroj:

EventLogTraceListener.cs

Zapíše trasovací informace, datový objekt a informace o událostech do protokolu událostí.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

Parametry

eventCache

TraceEventCache

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

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 jednoznačně identifikuje událost.

data

Object

Datový objekt pro zápis do výstupního souboru nebo datového proudu.

Atributy

ComVisibleAttribute

Výjimky

ArgumentException

source není zadáno.

-nebo-

Řetězec položky protokolu je delší než 32 766 znaků.

Poznámky

Důležité

Metody TraceData nejsou určeny k zavolání kódem aplikace. Jsou volána metodami Debugtříd , Tracea TraceSource pro výstup dat trasování.

Metoda TraceData je stejně jako TraceEvent metoda určená pro automatizované nástroje, ale umožňuje také připojení dalších objektů, například instance výjimky, k trasování.

Parametry eventCache a source se používají k určení, jestli se má událost trasovat. id se používá k vytvoření EventInstance objektu a TraceEventType je rovnítko EventLogEntryType pro vlastnost EntryType . Objekt EventInstance se zapíše do protokolu událostí pomocí objektu data naformátovaného jako řetězec 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.

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

Zdroj:

EventLogTraceListener.cs

Zapisuje trasovací informace, pole datových objektů a informace o událostech do protokolu událostí.

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

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

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

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

Parametry

eventCache

TraceEventCache

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

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 jednoznačně identifikuje událost.

data

Object[]

Pole datových objektů.

Atributy

ComVisibleAttribute

Výjimky

ArgumentException

source není zadáno.

-nebo-

Řetězec položky protokolu je delší než 32 766 znaků.

Poznámky

Důležité

Metody TraceData nejsou určeny k zavolání kódem aplikace. Jsou volána metodami Debugtříd , Tracea TraceSource pro výstup dat trasování.

Metoda TraceData je stejně jako TraceEvent metoda určená pro automatizované nástroje, ale umožňuje také připojení dalších objektů, například instance výjimky, k trasování.

Data parametru severity a id slouží k vytvoření objektu EventInstance , který se zapíše do protokolu událostí s daty z pole datových objektů.

Parametry eventCache a source se používají k určení, jestli se má událost trasovat. id se používá k vytvoření EventInstance objektu a TraceEventType je rovnítko EventLogEntryType pro vlastnost EntryType . Objekt EventInstance se zapíše do protokolu událostí pomocí data pole objektů ve formátu pole řetězců 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.