EventProvider.WriteMessageEvent 메서드

정의

문자열 데이터가 포함된 이벤트를 씁니다.Writes an event that contains a string as its data.

오버로드

WriteMessageEvent(String)

문자열 데이터가 포함된 이벤트를 씁니다.Writes an event that contains a string as its data.

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)

문자열 데이터가 포함된 이벤트를 씁니다.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 to write as the event data.

반환

이벤트가 작성되었으면 true이고, 그렇지 않으면 false입니다.Is true if the event is written; otherwise, false. false인 경우 GetLastWriteEventError() 메서드를 호출하여 실패한 원인을 확인할 수 있습니다.If false, call the GetLastWriteEventError() method to determine the cause of the failure.

예외

eventMessagenull인 경우입니다.If eventMessage is null.

예제

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

설명

최대 문자열 길이 이벤트 헤더의 크기를 뺀 값 64KB로 제한 됩니다.The maximum string length is limited to 64 KB minus the size of the event headers. 세션의 버퍼 크기가 더 작고 세션에 이벤트로 확장된 데이터 항목이 포함되어 있는 경우 이벤트 크기도 더 작습니다.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)

세션이 요청한 이벤트가 수준 및 키워드 값과 일치하는 경우 문자열 데이터가 들어 있는 이벤트를 씁니다.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 to write as the event data.

eventLevel
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

이벤트 범주를 지정하는 비트 마스크입니다.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. false인 경우 GetLastWriteEventError() 메서드를 호출하여 실패한 원인을 확인할 수 있습니다.If false, call the GetLastWriteEventError() method to determine the cause of the failure.

특성

예외

eventMessagenull인 경우입니다.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());  

설명

최대 문자열 길이 이벤트 헤더의 크기를 뺀 값 64KB로 제한 됩니다.The maximum string length is limited to 64 KB minus the size of the event headers. 세션의 버퍼 크기가 더 작고 세션에 이벤트로 확장된 데이터 항목이 포함되어 있는 경우 이벤트 크기도 더 작습니다.The event size is less if the session's buffer size is less and the session includes extended data items with the event.

적용 대상