EventSource.WriteEvent Метод

Определение

Пространство имен:

System.Diagnostics.Tracing

Сборки:

netstandard.dll, System.Diagnostics.Tracing.dll

Записывает событие с помощью предоставленного идентификатора события и необязательных аргументов.

Перегрузки

Имя	Описание
WriteEvent(Int32, String, Int32)	Записывает событие с помощью предоставленного идентификатора и аргументов события.
WriteEvent(Int32, String, Int64)	Записывает событие с помощью предоставленного идентификатора и аргументов события.
WriteEvent(Int32, String, String)	Записывает событие с помощью предоставленного идентификатора события и строковых аргументов.
WriteEvent(Int32, String)	Записывает событие с помощью предоставленного идентификатора события и аргумента строки.
WriteEvent(Int32, Int64, Int64, Int64)	Записывает событие с помощью предоставленного идентификатора события и 64-разрядных аргументов.
WriteEvent(Int32, String, Int32, Int32)	Записывает событие с помощью предоставленного идентификатора и аргументов события.
WriteEvent(Int32, Int64, String)	Записывает событие с помощью предоставленного идентификатора события и 64-разрядного целого числа и строковых аргументов.
WriteEvent(Int32, Int32, Int32, Int32)	Записывает событие с помощью предоставленного идентификатора события и 32-разрядных целых аргументов.
WriteEvent(Int32, Int64, Int64)	Записывает событие с помощью предоставленного идентификатора события и 64-разрядных аргументов.
WriteEvent(Int32, Object[])	Записывает событие с помощью предоставленного идентификатора события и массива аргументов.
WriteEvent(Int32, Int32, String)	Записывает событие с помощью предоставленного идентификатора события и 32-разрядного целого числа и строковых аргументов.
WriteEvent(Int32, Int32, Int32)	Записывает событие с помощью предоставленного идентификатора события и 32-разрядных целых аргументов.
WriteEvent(Int32, String, String, String)	Записывает событие с помощью предоставленного идентификатора события и строковых аргументов.
WriteEvent(Int32, Int64)	Записывает событие с помощью предоставленного идентификатора события и 64-разрядного целого числа.
WriteEvent(Int32, Int32)	Записывает событие с помощью предоставленного идентификатора события и 32-разрядного целого числа.
WriteEvent(Int32, EventSource+EventSourcePrimitive[])	Записывает событие с помощью предоставленного идентификатора события и переменного числа примитивов источника событий.
WriteEvent(Int32, Byte[])	Записывает событие с помощью предоставленного идентификатора события и аргумента массива байтов.
WriteEvent(Int32)	Записывает событие с помощью предоставленного идентификатора события.
WriteEvent(Int32, Int64, Byte[])	Записывает данные события с помощью указанного идентификатора и 64-разрядного целого числа и аргументов массива байтов.

Комментарии

Метод WriteEvent предоставляет перегрузки с сочетаниями строковых и целых аргументов. Если ни одно из этих сочетаний не соответствует параметрам вызова, компилятор использует EventSource.WriteEvent(Int32, Object[]) перегрузку, которая значительно медленнее, чем другие перегрузки. Дополнительные сведения см. на странице перегрузки.

Во всех случаях eventid параметр должен быть больше 0 или менее 65535 или ошибок в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

Можно также создать пользовательскую перегрузку с помощью WriteEventCore метода.

Это важно

Параметры события с типом string не должны содержать \0 символы. Они неподдерживаемые символы и могут вызывать проблемы для анализаторов полезных данных события.

WriteEvent(Int32, String, Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора и аргументов события.

protected:
 void WriteEvent(int eventId, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

arg2

Int32

32-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, String, Int64)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора и аргументов события.

protected:
 void WriteEvent(int eventId, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

arg2

Int64

64-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, String, String)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и строковых аргументов.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

arg2

String

Строковый аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, String)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и аргумента строки.

protected:
 void WriteEvent(int eventId, System::String ^ arg1);

protected void WriteEvent(int eventId, string? arg1);

member this.WriteEvent : int * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

Примеры

В следующем примере показано, как использовать эту перегрузку метода для записи события. Этот пример кода является частью более крупного примера, предоставленного для класса EventSource .

[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

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int64, Int64, Int64)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 64-разрядных аргументов.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int64

64-разрядный целочисленный аргумент.

arg2

Int64

64-разрядный целочисленный аргумент.

arg3

Int64

64-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, String, Int32, Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора и аргументов события.

protected:
 void WriteEvent(int eventId, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

arg2

Int32

32-разрядный целочисленный аргумент.

arg3

Int32

32-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int64, String)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 64-разрядного целого числа и строковых аргументов.

protected:
 void WriteEvent(int eventId, long arg1, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int64

64-разрядный целочисленный аргумент.

arg2

String

Строковый аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в EventSourceпроизводном классе, необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, аналогичный следующему примеру.

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

WriteEvent(Int32, Int32, Int32, Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 32-разрядных целых аргументов.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int32

Целочисленный аргумент.

arg2

Int32

Целочисленный аргумент.

arg3

Int32

Целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int64, Int64)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 64-разрядных аргументов.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int64

64-разрядный целочисленный аргумент.

arg2

Int64

64-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Object[])

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и массива аргументов.

protected:
 void WriteEvent(int eventId, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("EventSource will serialize the whole object graph. Trimmer will not safely handle this case because properties may be trimmed. This can be suppressed if the object is a primitive type")]
protected void WriteEvent(int eventId, params object?[] args);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("EventSource will serialize the whole object graph. Trimmer will not safely handle this case because properties may be trimmed. This can be suppressed if the object is a primitive type")>]
member this.WriteEvent : int * obj[] -> unit

Protected Sub WriteEvent (eventId As Integer, ParamArray args As Object())

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

args

Object[]

Массив объектов .

Атрибуты

RequiresUnreferencedCodeAttribute

Комментарии

По умолчанию компилятор вызывает эту перегрузку, если параметры вызова не соответствуют одной из перегрузок другого метода. Эта перегрузка гораздо медленнее, чем другие перегрузки, так как она выполняет следующие действия:

1. Он выделяет массив для хранения аргумента переменной.

2. Он приводит каждый параметр к объекту (что приводит к выделению для примитивных типов).

3. Он назначает эти объекты массиву.

4. Он вызывает функцию, которая затем определяет тип каждого аргумента, чтобы его можно было сериализовать для ETW.

Высокие издержки для этой перегрузки не являются значительными при трассировке событий с низким объемом, так как метод используется только в том случае, если поставщик включен. Однако для событий с большим объемом производительность может быть значительной. Вы можете избежать использования EventSource.WriteEvent для полезных данных с большим объемом, создавая новую, быструю перегрузку с WriteEventCore помощью метода.

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int32, String)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 32-разрядного целого числа и строковых аргументов.

protected:
 void WriteEvent(int eventId, int arg1, System::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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int32

32-разрядный целочисленный аргумент.

arg2

String

Строковый аргумент.

WriteEvent(Int32, Int32, Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 32-разрядных целых аргументов.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int32

Целочисленный аргумент.

arg2

Int32

Целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, String, String, String)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и строковых аргументов.

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);

member this.WriteEvent : int * string * string * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String, arg3 As String)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

String

Строковый аргумент.

arg2

String

Строковый аргумент.

arg3

String

Строковый аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int64)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 64-разрядного целого числа.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int64

64-разрядный целочисленный аргумент.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и 32-разрядного целого числа.

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)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int32

Целочисленный аргумент.

Примеры

В следующем примере показано, как использовать эту перегрузку метода для записи события. Этот пример кода является частью более крупного примера, предоставленного для класса EventSource .

[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

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, EventSource+EventSourcePrimitive[])

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и переменного числа примитивов источника событий.

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())

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

args

EventSource.EventSourcePrimitive[]

Примитивы источника событий.

Комментарии

Это вспомогательный элемент varargs для написания события. Он создает массив и поле всех аргументов, поэтому он относительно неэффективн и должен использоваться только для относительно редких событий (например, менее 100 в секунду). Если ваши ставки быстрее, чем это, используйте WriteEventCore(Int32, Int32, EventSource+EventData*) для создания быстрых вспомогательных для конкретной подписи метода. Даже если вы используете это для редких событий, этот вызов должен быть защищен проверкой IsEnabled() , чтобы вызов varargs не был выполнен, если EventSource не активен.

WriteEvent(Int32, Byte[])

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события и аргумента массива байтов.

protected:
 void WriteEvent(int eventId, cli::array <System::Byte> ^ arg1);

protected void WriteEvent(int eventId, byte[]? arg1);

member this.WriteEvent : int * byte[] -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Byte())

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Byte[]

Аргумент массива байтов.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32)

Исходный код:

EventSource.cs

Записывает событие с помощью предоставленного идентификатора события.

protected:
 void WriteEvent(int eventId);

protected void WriteEvent(int eventId);

member this.WriteEvent : int -> unit

Protected Sub WriteEvent (eventId As Integer)

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

Примеры

В следующем примере показано, как использовать эту перегрузку метода для записи события. Этот пример кода является частью более крупного примера, предоставленного для класса EventSource .

[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

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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

WriteEvent(Int32, Int64, Byte[])

Исходный код:

EventSource.cs

Записывает данные события с помощью указанного идентификатора и 64-разрядного целого числа и аргументов массива байтов.

protected:
 void WriteEvent(int eventId, long arg1, cli::array <System::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())

Параметры

eventId

Int32

Идентификатор события. Это значение должно быть от 0 до 65535.

arg1

Int64

64-разрядный целочисленный аргумент.

arg2

Byte[]

Аргумент массива байтов.

Комментарии

eventid должно быть больше 0 или менее 65535 или ошибки могут возникать в операции. Если возникают ошибки, вы можете получить дополнительные сведения об источнике ошибки, проверив выходной поток отладчика, если у вас есть отладчик, подключенный к событиям запуска процесса. Вы также можете искать ошибки, сообщаемые в потоке событий ETW, если у вас есть прослушиватель ETW в источнике событий, где возникает ошибка.

При реализации метода, который определяется как событие ETW в производном EventSourceклассе. Необходимо вызвать метод базового класса WriteEvent , передавая EventId и те же аргументы, что и реализованный метод, как показано в следующем примере.

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