Udostępnij za pośrednictwem


TraceSource.TraceEvent Metoda

Definicja

Zapisuje komunikat o zdarzeniu śledzenia do odbiorników śledzenia w kolekcji Listeners .

Przeciążenia

TraceEvent(TraceEventType, Int32)

Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia i identyfikatora zdarzenia.

TraceEvent(TraceEventType, Int32, String)

Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i komunikatu.

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

Zapisuje zdarzenie śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy argumentów i formatu.

TraceEvent(TraceEventType, Int32)

Źródło:
TraceSource.cs
Źródło:
TraceSource.cs
Źródło:
TraceSource.cs

Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia i identyfikatora zdarzenia.

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 -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parametry

eventType
TraceEventType

Jedna z wartości wyliczenia, która określa typ zdarzenia danych śledzenia.

id
Int32

Identyfikator liczbowy zdarzenia.

Atrybuty

Wyjątki

Podjęto próbę śledzenia zdarzenia podczas finalizacji.

Przykłady

Poniższy przykład kodu przedstawia użycie TraceEvent(TraceEventType, Int32) metody w celu przekazania zdarzenia śledzenia do odbiorników. Ten przykład kodu jest częścią większego przykładu podanego TraceSource dla klasy.

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Uwagi

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.

Metoda TraceEvent wywołuje metodę ShouldTrace obiektu zwróconego SourceSwitchSwitch przez właściwość. Jeśli ShouldTrace zwraca truewartość , TraceEvent wywołuje odpowiednią TraceEvent metodę każdego odbiornika. TraceEvent W przeciwnym razie zwraca wartość bez wywoływania metod odbiorników.

Zawartość śledzenia jest specyficzna dla odbiornika. Jeśli metoda nie jest zastępowana przez implementację odbiornika, domyślne dane wyjściowe to nazwa źródła śledzenia, jego tożsamość liczbowa i typ zdarzenia. Dodatkowa zawartość śledzenia zależy od wartości właściwości odbiornika TraceOutputOptions .

Uwaga

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona id wartość jest większa niż 65 535, EventLogTraceListener używa wartości 65 535.

Dotyczy

TraceEvent(TraceEventType, Int32, String)

Źródło:
TraceSource.cs
Źródło:
TraceSource.cs
Źródło:
TraceSource.cs

Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i komunikatu.

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 -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parametry

eventType
TraceEventType

Jedna z wartości wyliczenia, która określa typ zdarzenia danych śledzenia.

id
Int32

Identyfikator liczbowy zdarzenia.

message
String

Komunikat śledzenia do zapisania.

Atrybuty

Wyjątki

Podjęto próbę śledzenia zdarzenia podczas finalizacji.

Przykłady

Poniższy przykład kodu przedstawia użycie TraceEvent(TraceEventType, Int32) metody w celu przekazania zdarzenia śledzenia do odbiorników. Ten przykład kodu jest częścią większego przykładu podanego TraceSource dla klasy.

// 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")

Uwagi

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.

Metoda TraceEvent wywołuje metodę ShouldTrace obiektu zwróconego SourceSwitchSwitch przez właściwość. Jeśli ShouldTrace zwraca truewartość , TraceEvent wywołuje odpowiednią TraceEvent metodę każdego odbiornika. TraceEvent W przeciwnym razie zwraca wartość bez wywoływania metod odbiorników.

Zawartość śledzenia jest specyficzna dla odbiornika. Jeśli metoda nie jest zastępowana przez implementację odbiornika, domyślne dane wyjściowe to nazwa źródła śledzenia, jego tożsamość liczbowa, typ zdarzenia i komunikat. Dodatkowa zawartość śledzenia zależy od wartości właściwości odbiornika TraceOutputOptions .

Uwaga

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona id wartość jest większa niż 65 535, EventLogTraceListener obiekt używa wartości 65 535.

Dotyczy

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

Źródło:
TraceSource.cs
Źródło:
TraceSource.cs
Źródło:
TraceSource.cs

Zapisuje zdarzenie śledzenia do odbiorników śledzenia w Listeners kolekcji przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy argumentów i formatu.

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[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametry

eventType
TraceEventType

Jedna z wartości wyliczenia, która określa typ zdarzenia danych śledzenia.

id
Int32

Identyfikator liczbowy zdarzenia.

format
String

Ciąg formatu złożonego, który zawiera tekst mieszany z zero lub więcej elementów formatu, które odpowiadają obiektom w tablicy args .

args
Object[]

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

Atrybuty

Wyjątki

format to null.

Nazwa format jest niepoprawna.

-lub-

Liczba wskazująca argument do sformatowania jest mniejsza niż zero lub większa lub równa liczbie określonych obiektów do formatowania.

Podjęto próbę śledzenia zdarzenia podczas finalizacji.

Przykłady

Poniższy przykład kodu przedstawia użycie TraceEvent(TraceEventType, Int32) metody w celu przekazania zdarzenia śledzenia do odbiorników. Ten przykład kodu jest częścią większego przykładu podanego TraceSource dla klasy.

// 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")

Uwagi

Aby uzyskać więcej informacji na temat parametru format , zobacz Formatowanie złożone.

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.

Metoda TraceEvent wywołuje metodę ShouldTrace obiektu zwróconego SourceSwitchSwitch przez właściwość. Jeśli ShouldTrace zwraca truewartość , TraceEvent wywołuje odpowiednią TraceEvent metodę każdego odbiornika. TraceEvent W przeciwnym razie zwraca wartość bez wywoływania metod odbiorników.

Zawartość śledzenia jest specyficzna dla odbiornika. Metoda domyślna TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) zapisuje nazwę źródłową, typ zdarzenia i tożsamość liczbową w nagłówku śledzenia, a następnie wywołuje metodę String.Format(IFormatProvider, String, Object[]) , przekazując format ciąg i args tablicę oraz używając CultureInfo.InvariantCulture właściwości , aby sformatować ciąg jako dane wyjściowe komunikatu.

Uwaga

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona id wartość jest większa niż 65 535, EventLogTraceListener obiekt używa wartości 65 535.

Zobacz też

Dotyczy