EventProvider.WriteMessageEvent Метод

Определение

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

System.Diagnostics.Eventing

Сборка:

System.Core.dll

Записывает событие, которое содержит строку в качестве данных.

Перегрузки

WriteMessageEvent(String)	Записывает событие, которое содержит строку в качестве данных.
WriteMessageEvent(String, Byte, Int64)	Записывает событие, которое содержит строку в качестве данных, если уровень и ключевое слово соответствуют событиям, запрашиваемым сеансом.

Комментарии

Эти методы не требуют манифеста для использования события.

WriteMessageEvent(String)

Записывает событие, которое содержит строку в качестве данных.

public:
 bool WriteMessageEvent(System::String ^ eventMessage);

public bool WriteMessageEvent (string eventMessage);

member this.WriteMessageEvent : string -> bool

Public Function WriteMessageEvent (eventMessage As String) As Boolean

Параметры

eventMessage

String

Строка для записи в качестве данных события.

Возвращаемое значение

Boolean

Значение true, если событие записано, в противном случае — false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().

Исключения

ArgumentException

Если eventMessage имеет значение null.

Примеры

if (!provider.WriteMessageEvent("Event string."))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

Комментарии

Максимальная длина строки ограничена 64 КБ за вычетом размера заголовков событий. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.

WriteMessageEvent(String, Byte, Int64)

Записывает событие, которое содержит строку в качестве данных, если уровень и ключевое слово соответствуют событиям, запрашиваемым сеансом.

public:
 bool WriteMessageEvent(System::String ^ eventMessage, System::Byte eventLevel, long eventKeywords);

[System.Security.SecurityCritical]
public bool WriteMessageEvent (string eventMessage, byte eventLevel, long eventKeywords);

[<System.Security.SecurityCritical>]
member this.WriteMessageEvent : string * byte * int64 -> bool

Public Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As Boolean

Параметры

eventMessage

String

Строка для записи в качестве данных события.

eventLevel

Byte

Уровень детализации сведений, включаемых в событие. Если поставщик использует манифест для определения события, это значение устанавливается таким же, как и значение уровня, определенное в манифесте.

eventKeywords

Int64

Битовая маска, указывающая категорию события. Если поставщик использует манифест для определения события, это значение устанавливается таким же, как и значение маски ключевого слова, определенное в манифесте.

Возвращаемое значение

Boolean

Значение true, если событие записано, в противном случае — false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().

Атрибуты

SecurityCriticalAttribute

Исключения

ArgumentException

Если eventMessage имеет значение null.

Примеры

// Calling this method with level and keyword set to zero is the same  
// as calling WriteMessageEvent(string); the event is always written.  
if (!provider.WriteMessageEvent("Event string.", 0, 0))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

// Event is written if the level value of the session is less than or equal to 3, and bit 1 of the session  
// keyword bit-mask is set.  
if (!provider.WriteMessageEvent("Event string.", 3, 2))  
    Console.WriteLine(EventProvider.GetLastWriteEventError());  

Комментарии

Максимальная длина строки ограничена 64 КБ за вычетом размера заголовков событий. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.