EventProvider.WriteMessageEvent EventProvider.WriteMessageEvent EventProvider.WriteMessageEvent EventProvider.WriteMessageEvent Method

Определение

Записывает событие, которое содержит строку в качестве данных.Writes an event that contains a string as its data.

Перегрузки

WriteMessageEvent(String) WriteMessageEvent(String) WriteMessageEvent(String) WriteMessageEvent(String)

Записывает событие, которое содержит строку в качестве данных.Writes an event that contains a string as its data.

WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64)

Записывает событие, которое содержит строку в качестве данных, если уровень и ключевое слово соответствуют событиям, запрашиваемым сеансом.Writes an event that contains a string as its data if the level and keyword value match the events requested by the session.

Комментарии

Эти методы не требуют манифеста для использования события.These methods do not require a manifest to consume the event.

WriteMessageEvent(String) WriteMessageEvent(String) WriteMessageEvent(String) WriteMessageEvent(String)

Записывает событие, которое содержит строку в качестве данных.Writes an event that contains a string as its data.

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

Строка для записи в качестве данных события.String to write as the event data.

Возвраты

Значение true, если событие записано, в противном случае — false.Is true if the event is written; otherwise, false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Исключения

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

Примеры

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

Комментарии

Максимальная длина строки ограничена размером в 64 КБ минус размер заголовков событий.The maximum string length is limited to 64 KB minus the size of the event headers. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64) WriteMessageEvent(String, Byte, Int64)

Записывает событие, которое содержит строку в качестве данных, если уровень и ключевое слово соответствуют событиям, запрашиваемым сеансом.Writes an event that contains a string as its data if the level and keyword value match the events requested by the session.

public:
 bool WriteMessageEvent(System::String ^ eventMessage, System::Byte eventLevel, long eventKeywords);
[System.Security.SecurityCritical]
public bool WriteMessageEvent (string eventMessage, byte eventLevel, long eventKeywords);
member this.WriteMessageEvent : string * byte * int64 -> bool
Public Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As Boolean

Параметры

eventMessage
String String String String

Строка для записи в качестве данных события.String to write as the event data.

eventLevel
Byte Byte Byte Byte

Уровень детализации сведений, включаемых в событие.Level of detail included in the event. Если поставщик использует манифест для определения события, это значение устанавливается таким же, как и значение уровня, определенное в манифесте.If the provider uses a manifest to define the event, set this value to the same level defined in the manifest.

eventKeywords
Int64 Int64 Int64 Int64

Битовая маска, указывающая категорию события.Bit mask that specifies the event category. Если поставщик использует манифест для определения события, это значение устанавливается таким же, как и значение маски ключевого слова, определенное в манифесте.If the provider uses a manifest to define the event, set this value to the same keyword mask defined in the manifest.

Возвраты

Значение true, если событие записано, в противном случае — false.Is true if the event is written; otherwise, false. Если событие не записано, для определения причины сбоя можно использовать метод GetLastWriteEventError().If false, call the GetLastWriteEventError() method to determine the cause of the failure.

Исключения

Если eventMessage имеет значение null.If eventMessage is 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 КБ минус размер заголовков событий.The maximum string length is limited to 64 KB minus the size of the event headers. Размер события может быть меньше, если меньше размер буфера сеанса и сеанс включает вместе c событием расширенные элементы данных.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

Применяется к