EventProvider.WriteMessageEvent 메서드

정의

네임스페이스:
System.Diagnostics.Eventing
어셈블리:
System.Core.dll

문자열을 포함하는 이벤트를 해당 데이터로 씁니다.

오버로드

Name Description
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그렇지 않으면 .입니다. false이면 메서드를 GetLastWriteEventError() 호출하여 오류의 원인을 확인합니다.

예외

ArgumentException

이eventMessage면 null .

예제

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

설명

최대 문자열 길이는 이벤트 헤더의 크기를 뺀 64KB로 제한됩니다. 세션의 버퍼 크기가 적고 세션에 이벤트와 함께 확장된 데이터 항목이 포함된 경우 이벤트 크기가 줄어듭니다.

적용 대상

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그렇지 않으면 .입니다. 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());

설명

최대 문자열 길이는 이벤트 헤더의 크기를 뺀 64KB로 제한됩니다. 세션의 버퍼 크기가 적고 세션에 이벤트와 함께 확장된 데이터 항목이 포함된 경우 이벤트 크기가 줄어듭니다.

적용 대상