TraceSource.TraceEvent Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Diagnostics

Zestaw:: System.Diagnostics.TraceSource.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w kolekcji Listeners.

Przeciążenia

TraceEvent(TraceEventType, Int32)	Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w kolekcji Listeners przy użyciu określonego typu zdarzenia i identyfikatora zdarzenia.
TraceEvent(TraceEventType, Int32, String)	Zapisuje komunikat zdarzenia śledzenia do odbiorników śledzenia w kolekcji Listeners przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i komunikatu.
TraceEvent(TraceEventType, Int32, String, Object[])	Zapisuje zdarzenie śledzenia do odbiorników śledzenia w kolekcji Listeners przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy argumentów oraz 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 kolekcji Listeners 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 określająca typ zdarzenia danych śledzenia.

id: Int32

Identyfikator liczbowy zdarzenia.

Atrybuty: ConditionalAttribute

Wyjątki

ObjectDisposedException

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

Przykłady

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

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Uwagi

Metoda TraceEvent służy 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 SourceSwitch zwróconą przez właściwość Switch. Jeśli ShouldTrace zwraca true, TraceEvent wywołuje odpowiednią metodę TraceEvent każdego odbiornika. W przeciwnym razie TraceEvent zwraca 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 TraceOutputOptions odbiornika.

Nuta

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona wartość id 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 kolekcji Listeners 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 określająca typ zdarzenia danych śledzenia.

id: Int32

Identyfikator liczbowy zdarzenia.

message: String

Komunikat śledzenia do zapisania.

Atrybuty: ConditionalAttribute

Wyjątki

ObjectDisposedException

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

Przykłady

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

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 TraceOutputOptions odbiornika.

Nuta

Obiekt EventLogTraceListener jest ograniczony do maksymalnej id wartości 65 535. Jeśli określona wartość id jest większa niż 65 535, obiekt EventLogTraceListener 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 kolekcji Listeners przy użyciu określonego typu zdarzenia, identyfikatora zdarzenia i tablicy argumentów oraz 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 określająca 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 object zawierająca zero lub więcej obiektów do sformatowania.

Atrybuty: ConditionalAttribute

Wyjątki

ArgumentNullException

format jest null.

FormatException

format jest nieprawidłowa.

-lub-

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

ObjectDisposedException

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

Przykłady

// 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 Composite Formatting.

Zawartość śledzenia jest specyficzna dla odbiornika. Domyślna metoda 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 ciąg format i tablicę args oraz używając właściwości CultureInfo.InvariantCulture, aby sformatować ciąg jako dane wyjściowe komunikatu.

Nuta

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

Zobacz też

formatowanie złożone
standardowych ciągów formatu liczbowego
niestandardowe ciągi formatu liczbowego
standardowe ciągi formatu DateTime
niestandardowe ciągi formatu daty/godziny
ciągi formatu wyliczenia
typy formatowania na platformie .NET

Dotyczy

Udostępnij za pośrednictwem

TraceSource.TraceEvent Metoda

Definicja

Przeciążenia

TraceEvent(TraceEventType, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

TraceEvent(TraceEventType, Int32, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby