Udostępnij za pośrednictwem


EventSource.WriteEvent Metoda

Definicja

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i opcjonalnych argumentów.

Przeciążenia

WriteEvent(Int32, String, String, String)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu.

WriteEvent(Int32, String, Int32, Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

WriteEvent(Int32, Int64, Int64, Int64)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych.

WriteEvent(Int32, Int32, Int32, Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów liczb całkowitych.

WriteEvent(Int32, String, String)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu.

WriteEvent(Int32, String, Int64)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

WriteEvent(Int32, String, Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

WriteEvent(Int32, Int64, String)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej oraz argumentów ciągu.

WriteEvent(Int32, Int64, Int64)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych.

WriteEvent(Int32, Int32, Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów liczb całkowitych.

WriteEvent(Int32, Int32, String)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej i argumentów ciągu.

WriteEvent(Int32, String)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu ciągu.

WriteEvent(Int32, Object[])

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i tablicy argumentów.

WriteEvent(Int32, Int64)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej.

WriteEvent(Int32, Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej.

WriteEvent(Int32, EventSource+EventSourcePrimitive[])

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i zmiennej liczby elementów pierwotnych źródła zdarzeń.

WriteEvent(Int32, Byte[])

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu tablicy bajtów.

WriteEvent(Int32)

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia.

WriteEvent(Int32, Int64, Byte[])

Zapisuje dane zdarzenia przy użyciu określonego identyfikatora i 64-bitowej liczby całkowitej i argumentów tablicy bajtów.

Uwagi

Metoda WriteEvent zapewnia przeciążenia z kombinacjami argumentów ciągów i liczb całkowitych. Jeśli żadna z tych kombinacji nie pasuje do parametrów wywołania, kompilator używa EventSource.WriteEvent(Int32, Object[]) przeciążenia, co jest znacznie wolniejsze niż inne przeciążenia. Aby uzyskać szczegółowe informacje, zobacz stronę przeciążenia.

We wszystkich przypadkach eventid parametr powinien być większy niż 0 lub mniejszy niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Można również utworzyć przeciążenie niestandardowe przy użyciu WriteEventCore metody .

Ważne

Parametry zdarzenia z typem string nie powinny zawierać \0 znaków. Są to nieobsługiwane znaki i mogą powodować problemy z analizatorami ładunku zdarzenia.

WriteEvent(Int32, String, String, String)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2, System::String ^ arg3);
protected void WriteEvent (int eventId, string arg1, string arg2, string arg3);
protected void WriteEvent (int eventId, string? arg1, string? arg2, string? arg3);
member this.WriteEvent : int * string * string * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String, arg3 As String)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

arg2
String

Argument ciągu.

arg3
String

Argument ciągu.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, String, Int32, Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, string arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, string? arg1, int arg2, int arg3);
member this.WriteEvent : int * string * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer, arg3 As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

arg2
Int32

Argument 32-bitowej liczby całkowitej.

arg3
Int32

Argument 32-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int64, Int64, Int64)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych.

protected:
 void WriteEvent(int eventId, long arg1, long arg2, long arg3);
protected void WriteEvent (int eventId, long arg1, long arg2, long arg3);
member this.WriteEvent : int * int64 * int64 * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long, arg3 As Long)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int64

Argument 64-bitowej liczby całkowitej.

arg2
Int64

Argument 64-bitowej liczby całkowitej.

arg3
Int64

Argument 64-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int32, Int32, Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów liczb całkowitych.

protected:
 void WriteEvent(int eventId, int arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, int arg1, int arg2, int arg3);
member this.WriteEvent : int * int * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer, arg3 As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int32

Argument liczby całkowitej.

arg2
Int32

Argument liczby całkowitej.

arg3
Int32

Argument liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, String, String)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów ciągu.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, string arg1, string arg2);
protected void WriteEvent (int eventId, string? arg1, string? arg2);
member this.WriteEvent : int * string * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

arg2
String

Argument ciągu.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, String, Int64)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, long arg2);
protected void WriteEvent (int eventId, string arg1, long arg2);
protected void WriteEvent (int eventId, string? arg1, long arg2);
member this.WriteEvent : int * string * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Long)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

arg2
Int64

Argument 64-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, String, Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, int arg2);
protected void WriteEvent (int eventId, string arg1, int arg2);
protected void WriteEvent (int eventId, string? arg1, int arg2);
member this.WriteEvent : int * string * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

arg2
Int32

Argument 32-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int64, String)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej oraz argumentów ciągu.

protected:
 void WriteEvent(int eventId, long arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, long arg1, string arg2);
protected void WriteEvent (int eventId, long arg1, string? arg2);
member this.WriteEvent : int * int64 * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As String)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int64

Argument 64-bitowej liczby całkowitej.

arg2
String

Argument ciągu.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, string arg2)
{
    base.WriteEvent(2, arg1, arg2);
}

Dotyczy

WriteEvent(Int32, Int64, Int64)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentów 64-bitowych.

protected:
 void WriteEvent(int eventId, long arg1, long arg2);
protected void WriteEvent (int eventId, long arg1, long arg2);
member this.WriteEvent : int * int64 * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int64

Argument 64-bitowej liczby całkowitej.

arg2
Int64

Argument 64-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int32, Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowych argumentów liczb całkowitych.

protected:
 void WriteEvent(int eventId, int arg1, int arg2);
protected void WriteEvent (int eventId, int arg1, int arg2);
member this.WriteEvent : int * int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int32

Argument liczby całkowitej.

arg2
Int32

Argument liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1, int arg2, int arg3)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int32, String)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej i argumentów ciągu.

protected:
 void WriteEvent(int eventId, int arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, int arg1, string arg2);
protected void WriteEvent (int eventId, int arg1, string? arg2);
member this.WriteEvent : int * int * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As String)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int32

Argument 32-bitowej liczby całkowitej.

arg2
String

Argument ciągu.

Dotyczy

WriteEvent(Int32, String)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu ciągu.

protected:
 void WriteEvent(int eventId, System::String ^ arg1);
protected void WriteEvent (int eventId, string arg1);
protected void WriteEvent (int eventId, string? arg1);
member this.WriteEvent : int * string -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As String)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
String

Argument ciągu.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą tego przeciążenia metody napisać zdarzenie. Ten przykład kodu jest częścią większego przykładu podanego EventSource dla klasy.

[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }
<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
    WriteEvent(1, message)
End Sub

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Object[])

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i tablicy argumentów.

protected:
 void WriteEvent(int eventId, ... cli::array <System::Object ^> ^ args);
protected void WriteEvent (int eventId, params object[] args);
protected void WriteEvent (int eventId, params object?[] args);
member this.WriteEvent : int * obj[] -> unit
Protected Sub WriteEvent (eventId As Integer, ParamArray args As Object())

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

args
Object[]

Tablica obiektów.

Uwagi

Domyślnie kompilator wywołuje to przeciążenie, jeśli parametry wywołania nie są zgodne z jednym z innych przeciążeń metody. To przeciążenie jest znacznie wolniejsze niż inne przeciążenia, ponieważ wykonuje następujące czynności:

  1. Przydziela tablicę do przechowywania argumentu zmiennej.

  2. Rzutuje każdy parametr do obiektu (co powoduje alokacje dla typów pierwotnych).

  3. Przypisuje te obiekty do tablicy.

  4. Wywołuje funkcję, która następnie określa typ każdego argumentu, aby można było serializować dla funkcji ETW.

Wysokie obciążenie dla tego przeciążenia nie ma znaczenia podczas śledzenia zdarzeń o niskim woluminie, ponieważ metoda jest używana tylko wtedy, gdy dostawca jest włączony. Jednak w przypadku zdarzeń o dużej ilości obciążenie wydajności może być znaczące. W przypadku ładunków o dużej ilości można uniknąć, EventSource.WriteEvent tworząc nowe, szybsze przeciążenie za pomocą WriteEventCore metody .

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int64)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 64-bitowej liczby całkowitej.

protected:
 void WriteEvent(int eventId, long arg1);
protected void WriteEvent (int eventId, long arg1);
member this.WriteEvent : int * int64 -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int64

Argument 64-bitowej liczby całkowitej.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i 32-bitowej liczby całkowitej.

protected:
 void WriteEvent(int eventId, int arg1);
protected void WriteEvent (int eventId, int arg1);
member this.WriteEvent : int * int -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int32

Argument liczby całkowitej.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą tego przeciążenia metody napisać zdarzenie. Ten przykład kodu jest częścią większego przykładu podanego EventSource dla klasy.

[Event(4, Opcode = EventOpcode.Stop, Task = Tasks.Page, Keywords = Keywords.Page, Level = EventLevel.Informational)]
public void PageStop(int ID) { if (IsEnabled()) WriteEvent(4, ID); }
<[Event](4, Opcode:=EventOpcode.Stop, Task:=Tasks.Page, Keywords:=Keywords.Page, Level:=EventLevel.Informational)> _
Public Sub PageStop(ByVal ID As Integer)
    If IsEnabled() Then
        WriteEvent(4, ID)
    End If
End Sub

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(int  arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, EventSource+EventSourcePrimitive[])

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i zmiennej liczby elementów pierwotnych źródła zdarzeń.

protected:
 void WriteEvent(int eventId, ... cli::array <System::Diagnostics::Tracing::EventSource::EventSourcePrimitive> ^ args);
protected void WriteEvent (int eventId, params System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] args);
member this.WriteEvent : int * System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] -> unit
Protected Sub WriteEvent (eventId As Integer, ParamArray args As EventSource.EventSourcePrimitive())

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

args
EventSource.EventSourcePrimitive[]

Źródła zdarzeń pierwotne.

Uwagi

Jest to pomocnik varargs do pisania zdarzenia. Tworzy tablicę i pole wszystkich argumentów, więc jest stosunkowo nieefektywny i powinien być używany tylko dla stosunkowo rzadkich zdarzeń (na przykład mniej niż 100 na sekundę). Jeśli stawki są szybsze, użyj WriteEventCore(Int32, Int32, EventSource+EventData*) polecenia , aby utworzyć szybkie pomocniki dla sygnatury określonej metody. Nawet jeśli jest to używane w przypadku rzadkich zdarzeń, to wywołanie powinno być chronione przez IsEnabled() sprawdzenie, aby wywołanie varargs nie było wykonywane, gdy źródło zdarzeń nie jest aktywne.

Dotyczy

WriteEvent(Int32, Byte[])

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia i argumentu tablicy bajtów.

protected:
 void WriteEvent(int eventId, cli::array <System::Byte> ^ arg1);
protected void WriteEvent (int eventId, byte[] arg1);
protected void WriteEvent (int eventId, byte[]? arg1);
member this.WriteEvent : int * byte[] -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Byte())

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Byte[]

Argument tablicy bajtów.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(byte[] arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32)

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

Zapisuje zdarzenie przy użyciu podanego identyfikatora zdarzenia.

protected:
 void WriteEvent(int eventId);
protected void WriteEvent (int eventId);
member this.WriteEvent : int -> unit
Protected Sub WriteEvent (eventId As Integer)

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą tego przeciążenia metody napisać zdarzenie. Ten przykład kodu jest częścią większego przykładu podanego EventSource dla klasy.

[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }
<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
    WriteEvent(1, message)
End Sub

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

Dotyczy

WriteEvent(Int32, Int64, Byte[])

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

Zapisuje dane zdarzenia przy użyciu określonego identyfikatora i 64-bitowej liczby całkowitej i argumentów tablicy bajtów.

protected:
 void WriteEvent(int eventId, long arg1, cli::array <System::Byte> ^ arg2);
protected void WriteEvent (int eventId, long arg1, byte[] arg2);
protected void WriteEvent (int eventId, long arg1, byte[]? arg2);
member this.WriteEvent : int * int64 * byte[] -> unit
Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Byte())

Parametry

eventId
Int32

Identyfikator zdarzenia. Ta wartość powinna należeć do zakresu od 0 do 65535.

arg1
Int64

Argument 64-bitowej liczby całkowitej.

arg2
Byte[]

Argument tablicy bajtów.

Uwagi

eventid powinna być większa niż 0 lub mniejsza niż 65535 lub błędy mogą wystąpić w operacji. Jeśli wystąpią błędy, możesz uzyskać więcej informacji o źródle błędu, sprawdzając strumień wyjściowy debugera, jeśli masz debuger dołączony do zdarzeń wypalania procesu. Możesz również wyszukać błędy zgłaszane w strumieniu zdarzeń ETW, jeśli masz odbiornik ETW w źródle zdarzeń, w którym występuje błąd.

Podczas implementowania metody, która jest identyfikowana jako zdarzenie ETW w klasie pochodnej EventSource. Należy wywołać metodę klasy WriteEvent bazowej przekazującą EventId i te same argumenty co zaimplementowana metoda podobna do poniższego przykładu.

[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, Byte[] arg2)
{
    base.WriteEvent(2, arg1, arg2);
}

Dotyczy