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입니다. 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로 제한됩니다. 세션의 버퍼 크기가 더 작고 세션에 이벤트로 확장된 데이터 항목이 포함되어 있는 경우 이벤트 크기도 더 작습니다.