EventLogTraceListener.TraceEvent Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Zapisuje informacje o śledzeniu zdarzeń w dzienniku zdarzeń.

Przeciążenia

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

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

Źródło:

EventLogTraceListener.cs

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

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

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.

message

String

Komunikat śledzenia.

Atrybuty

ComVisibleAttribute

Wyjątki

ArgumentException

source nie jest określony.

-lub-

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

Uwagi

Ważne

Metody TraceEvent nie mają być wywoływane przez kod aplikacji. Te metody są wywoływane przez metody Debugklasy , Tracei TraceSource do zapisu danych śledzenia.

Metoda jest przeznaczona TraceEvent do śledzenia zdarzeń, które mogą być przetwarzane automatycznie przez narzędzia. Na przykład narzędzie do monitorowania może powiadomić administratora, jeśli określone zdarzenie jest śledzone przez określone źródło.

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 zdarzeń przy message użyciu danych 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ść.

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

Źródło:

EventLogTraceListener.cs

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

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

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.

format

String

Ciąg formatu zawierający zero lub więcej elementów formatu odpowiadających obiektom w tablicy args .

args

Object[]

Tablica zawierająca object zero lub więcej obiektów do sformatowania.

Atrybuty

ComVisibleAttribute

Wyjątki

ArgumentException

source nie jest określony.

-lub-

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

Uwagi

Ważne

Metody TraceEvent nie mają być wywoływane przez kod aplikacji. Te metody są wywoływane przez metody Debugklasy , Tracei TraceSource do zapisu danych śledzenia.

Metoda jest przeznaczona TraceEvent do śledzenia zdarzeń, które mogą być przetwarzane automatycznie przez narzędzia. Na przykład narzędzie do monitorowania może powiadomić administratora, jeśli określone zdarzenie jest śledzone przez określone źródło.

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 WriteEvent zdarzeń przy użyciu metody z komunikatem uzyskanym z format parametrów i args . Tablica args obiektów jest konwertowana na ciąg przy użyciu Format metody , przekazując format ciąg i args tablicę, aby sformatować ciąg jako komunikat dziennika zdarzeń.

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ść.