TraceSource.TraceEvent Metoda
Definicja
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 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)
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 -> unitPublic 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 TraceEvent ma na celu śledzenie 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 SourceSwitch Switch 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)
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 -> unitPublic 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 TraceEvent ma na celu śledzenie 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 SourceSwitch Switch 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[])
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[] -> unitPublic 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.
format jest nieprawidłowy.
-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 TraceEvent ma na celu śledzenie 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 SourceSwitch Switch 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ż
- Złożone formatowanie
- Standardowe ciągi formatujące liczby
- Niestandardowe ciągi formatujące liczby
- Standardowe ciągi formatu DateTime
- Niestandardowe ciągi formatu daty/godziny
- Wyliczanie ciągów formatujących
- Typy formatowania na platformie .NET