EventLogTraceListener.TraceData Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Zapisuje dane śledzenia w dzienniku zdarzeń.

Przeciążenia

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje informacje dotyczące śledzenia, obiektu danych i informacji o zdarzeniach w dzienniku zdarzeń.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach w dzienniku zdarzeń.

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

Źródło:

EventLogTraceListener.cs

Zapisuje informacje dotyczące śledzenia, obiektu danych i informacji o zdarzeniach w dzienniku zdarzeń.

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

Obiekt, który zawiera bieżący identyfikator procesu, identyfikator wątku i informacje śledzenia stosu.

source

String

Nazwa używana do identyfikowania danych wyjściowych; zazwyczaj nazwa aplikacji, która wygenerowała zdarzenie śledzenia.

severity

TraceEventType

Jedna z wartości wyliczenia określająca typ zdarzenia, które spowodowało ślad.

id

Int32

Identyfikator liczbowy zdarzenia. Kombinacja source i id unikatowo identyfikuje zdarzenie.

data

Object

Obiekt danych do zapisu w pliku wyjściowym lub strumieniu.

Atrybuty

ComVisibleAttribute

Wyjątki

ArgumentException

source nie jest określony.

-lub-

Ciąg wpisu dziennika przekracza 32 766 znaków.

Uwagi

Ważne

Metody TraceData nie mają być wywoływane przez kod aplikacji. Są one wywoływane przez metody Debugklasy , Tracei TraceSource do danych śledzenia danych wyjściowych.

Metoda TraceData , podobnie jak TraceEvent metoda, jest przeznaczona dla zautomatyzowanych narzędzi, ale umożliwia również dołączanie dodatkowych obiektów, na przykład wystąpienia wyjątku, do śledzenia.

Parametry eventCache i source służą do określania, czy zdarzenie ma być śledzone. idsłuży do tworzenia EventInstance obiektu, a obiekt TraceEventType jest utożsamiany z właściwością EntryTypeEventLogEntryType . Element EventInstance jest zapisywany w dzienniku data zdarzeń z obiektem sformatowanym jako ciąg przy użyciu WriteEvent metody .

Uwaga

Maksymalna wartość parametru id to 65 535. Jeśli określona id wartość jest większa niż 65 535, zostanie użyta maksymalna wartość.

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

Źródło:

EventLogTraceListener.cs

Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach w dzienniku zdarzeń.

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

Obiekt, który zawiera bieżący identyfikator procesu, identyfikator wątku i informacje śledzenia stosu.

source

String

Nazwa używana do identyfikowania danych wyjściowych; zazwyczaj nazwa aplikacji, która wygenerowała zdarzenie śledzenia.

severity

TraceEventType

Jedna z wartości wyliczenia określająca typ zdarzenia, które spowodowało ślad.

id

Int32

Identyfikator liczbowy zdarzenia. Kombinacja source i id unikatowo identyfikuje zdarzenie.

data

Object[]

Tablica obiektów danych.

Atrybuty

ComVisibleAttribute

Wyjątki

ArgumentException

source nie jest określony.

-lub-

Ciąg wpisu dziennika przekracza 32 766 znaków.

Uwagi

Ważne

Metody TraceData nie mają być wywoływane przez kod aplikacji. Są one wywoływane przez metody Debugklasy , Tracei TraceSource do danych śledzenia danych wyjściowych.

Metoda TraceData , podobnie jak TraceEvent metoda, jest przeznaczona dla zautomatyzowanych narzędzi, ale umożliwia również dołączanie dodatkowych obiektów, na przykład wystąpienia wyjątku, do śledzenia.

Dane severity parametrów i id służą do tworzenia EventInstance obiektu, który jest zapisywany w dzienniku zdarzeń z danymi z tablicy obiektów danych.

Parametry eventCache i source służą do określania, czy zdarzenie ma być śledzone. idsłuży do tworzenia EventInstance obiektu, a obiekt TraceEventType jest utożsamiany z właściwością EntryTypeEventLogEntryType . Element EventInstance jest zapisywany w dzienniku data zdarzeń z tablicą obiektów sformatowaną jako tablica ciągów przy użyciu WriteEvent metody .

Uwaga

Maksymalna wartość parametru id to 65 535. Jeśli określona id wartość jest większa niż 65 535, zostanie użyta maksymalna wartość.