EventProvider.WriteTransferEvent Yöntem

Tanım

Ad Alanı:

System.Diagnostics.Eventing

Bütünleştirilmiş Kod:

System.Core.dll

Uçtan uca bir senaryoda olayları izlerken olayları birbirine bağlar.

Aşırı Yüklemeler

WriteTransferEvent(EventDescriptor, Guid, Object[])	Uçtan uca bir senaryoda olayları izlerken olayları birbirine bağlar. Olay verileri bir nesne dizisi olarak belirtilir.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Uçtan uca bir senaryoda olayları izlerken olayları birbirine bağlar. Olay verileri bir bellek bloğu olarak belirtilir.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Uçtan uca bir senaryoda olayları izlerken olayları birbirine bağlar. Olay verileri bir nesne dizisi olarak belirtilir.

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);

[<System.Security.SecurityCritical>]
member this.WriteTransferEvent : EventDescriptor * Guid * obj[] -> bool

Public Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As Boolean

Parametreler

eventDescriptor

EventDescriptor

Yazacak olayı tanımlayan bir örneği EventDescriptor .

relatedActivityId

Guid

Önceki bileşenden etkinlik tanımlayıcısı. Bileşeninizin olaylarını önceki bileşenin olaylarına bağlamak için bu parametreyi kullanın.

eventPayload

Object[]

Yazacak olay verilerini içeren bir nesne dizisi. Verilerin bildirimde belirtilen sırada olması gerekir. Dizi 32 nesneyle sınırlıdır ve bunlardan yalnızca sekizi dize olabilir. Olay için maksimum veri boyutu, olay üst bilgilerinin boyutu eksi 64 KB ile sınırlıdır. Oturumun arabellek boyutu daha küçükse ve oturum olayla birlikte genişletilmiş veri öğeleri içeriyorsa olay boyutu daha azdır.

Döndürülenler

Boolean

Olay true yazıldıysa, yazıldıysa, falseolur. False ise, hatanın GetLastWriteEventError() nedenini belirlemek için yöntemini çağırın.

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

ArgumentException

Çok eventPayload fazla nesne veya dize içeriyorsa.

Açıklamalar

yöntemi, bu bileşeni tanımlamak için iş parçacığı bağlamında ayarlanan etkinlik kimliğini kullanır. Etkinlik kimliğini ayarlamak için yöntemini çağırın SetActivityId .

sınıfını Trace kullanırsanız, etkinlik kimliğini belirtmek için yöntemini kullanmazsınız SetActivityId . Bunun yerine, nesnesini almak için özelliğine erişin CorrelationManagerCorrelationManager . Ardından, özelliğini etkinlik kimliği olarak ayarlayın ActivityId . değerini de bir ActivityId değer olarak ayarlamanız relatedActivityId gerekir.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Uçtan uca bir senaryoda olayları izlerken olayları birbirine bağlar. Olay verileri bir bellek bloğu olarak belirtilir.

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);

[<System.Security.SecurityCritical>]
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

Parametreler

eventDescriptor

EventDescriptor

Yazacak olayı tanımlayan bir örneği EventDescriptor .

relatedActivityId

Guid

Önceki bileşenden etkinlik tanımlayıcısı. Bileşeninizin olaylarını önceki bileşenin olaylarına bağlamak için bu parametreyi kullanın.

dataCount

Int32

Parametrenin işaret ettiği olay verilerinin data boyutu. En büyük olay verisi boyutu, olay üst bilgilerinin boyutu eksi 64 KB ile sınırlıdır. Oturumun arabellek boyutu daha küçükse ve oturum olayla birlikte genişletilmiş veri öğeleri içeriyorsa olay boyutu daha azdır.

data

IntPtr

nativeint

Yazacak olay verilerinin işaretçisi.

Döndürülenler

Boolean

Olay true yazıldıysa, yazıldıysa, falseolur. False ise, hatanın GetLastWriteEventError() nedenini belirlemek için yöntemini çağırın.

Öznitelikler

SecurityCriticalAttribute

Açıklamalar

yöntemi, bu bileşeni tanımlamak için iş parçacığı bağlamında ayarlanan etkinlik kimliğini kullanır. Etkinlik kimliğini ayarlamak için yöntemini çağırın SetActivityId .