EventProvider.WriteTransferEvent 메서드

정의

엔드투엔드 시나리오에서 이벤트를 추적할 때 이벤트를 서로 링크합니다.Links events together when tracing events in an end-to-end scenario.

오버로드

WriteTransferEvent(EventDescriptor, Guid, Object[])

엔드투엔드 시나리오에서 이벤트를 추적할 때 이벤트를 서로 링크합니다.Links events together when tracing events in an end-to-end scenario. 이벤트 데이터는 개체 배열로 지정됩니다.The event data is specified as an array of objects.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

엔드투엔드 시나리오에서 이벤트를 추적할 때 이벤트를 서로 링크합니다.Links events together when tracing events in an end-to-end scenario. 이벤트 데이터는 메모리 블록으로 지정됩니다.The event data is specified as a block of memory.

WriteTransferEvent(EventDescriptor, Guid, Object[])

엔드투엔드 시나리오에서 이벤트를 추적할 때 이벤트를 서로 링크합니다.Links events together when tracing events in an end-to-end scenario. 이벤트 데이터는 개체 배열로 지정됩니다.The event data is specified as an array of objects.

public:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, ... cli::array <System::Object ^> ^ eventPayload);
[System.Security.SecurityCritical]
public bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, params object[] eventPayload);
member this.WriteTransferEvent : EventDescriptor * Guid * obj[] -> bool
Public Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As Boolean

매개 변수

eventDescriptor
EventDescriptor

작성할 이벤트를 식별하는 EventDescriptor의 인스턴스입니다.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid

이전 구성 요소에서 가져온 작업 식별자입니다.Activity identifier from the previous component. 이 매개 변수를 사용하여 구성 요소의 이벤트를 이전 구성 요소의 이벤트에 링크할 수 있습니다.Use this parameter to link your component's events to the previous component's events.

eventPayload
Object[]

작성할 이벤트 데이터가 들어 있는 개체 배열입니다.An array of objects that contain the event data to write. 데이터는 매니페스트에 지정된 순서대로 배치되어야 합니다.The data must be in the order specified in the manifest. 배열의 최대 크기는 32개체이며, 이 중 문자열은 최대 8개만 사용할 수 있습니다.The array is limited to 32 objects, of which only eight may be strings. 이벤트의 최대 데이터 크기는 64KB에서 이벤트 헤더의 크기를 뺀 값으로 제한됩니다.The maximum data size for the event 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.

반환

이벤트가 작성되었으면 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.

특성

예외

eventPayload에 너무 많은 개체나 문자열이 포함된 경우If eventPayload contains too many objects or strings.

설명

메서드를 스레드 컨텍스트에서 설정 된 작업 ID를 사용 하 여이 구성 요소를 식별 합니다.The method uses the activity ID set in the thread context to identify this component. 작업 ID를 설정 하려면 호출을 SetActivityId 메서드.To set the activity ID, call the SetActivityId method.

사용 하는 경우는 Trace 클래스를 사용 하지 않는 것을 SetActivityId 활동 ID를 지정 하는 방법If you use the Trace class, you do not use the SetActivityId method to specify the activity ID. 대신, 액세스를 CorrelationManager 가져올 속성을 CorrelationManager 개체입니다.Instead, access the CorrelationManager property to get the CorrelationManager object. 그런 다음 설정의 ActivityId 속성 작업 id와 같습니다.Then, set the ActivityId property to the activity ID. 설정 해야 합니다 relatedActivityIdActivityId 값입니다.You must also set the relatedActivityId to a ActivityId value.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

엔드투엔드 시나리오에서 이벤트를 추적할 때 이벤트를 서로 링크합니다.Links events together when tracing events in an end-to-end scenario. 이벤트 데이터는 메모리 블록으로 지정됩니다.The event data is specified as a block of memory.

protected:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
[System.Security.SecurityCritical]
protected bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
member this.WriteTransferEvent : EventDescriptor * Guid * int * nativeint -> bool
Protected Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, dataCount As Integer, data As IntPtr) As Boolean

매개 변수

eventDescriptor
EventDescriptor

작성할 이벤트를 식별하는 EventDescriptor의 인스턴스입니다.An instance of EventDescriptor that identifies the event to write.

relatedActivityId
Guid

이전 구성 요소에서 가져온 작업 식별자입니다.Activity identifier from the previous component. 이 매개 변수를 사용하여 구성 요소의 이벤트를 이전 구성 요소의 이벤트에 링크할 수 있습니다.Use this parameter to link your component's events to the previous component's events.

dataCount
Int32

data 매개 변수가 가리키는 이벤트 데이터의 크기입니다.Size of the event data to which the data parameter points. 이벤트 데이터의 최대 크기는 64KB에서 이벤트 헤더의 크기를 뺀 값으로 제한됩니다.The maximum event data size 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.

data
IntPtr

작성할 이벤트 데이터에 대한 포인터입니다.Pointer to the event data to write.

반환

이벤트가 작성되었으면 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.

특성

설명

메서드를 스레드 컨텍스트에서 설정 된 작업 ID를 사용 하 여이 구성 요소를 식별 합니다.The method uses the activity ID set in the thread context to identify this component. 작업 ID를 설정 하려면 호출을 SetActivityId 메서드.To set the activity ID, call the SetActivityId method.

적용 대상