EventProvider.WriteTransferEvent Yöntem

  • Başvuru

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 hariç 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ılırsa, aksi takdirde falseolur. False ise, hatanın GetLastWriteEventError() nedenini belirlemek için yöntemini çağırın.

Öznitelikler
SecurityCriticalAttribute

Özel durumlar

ArgumentException

eventPayload Çok 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ğine ayarlayın ActivityId . değerini de bir ActivityId değere ayarlamanız relatedActivityId gerekir.

Şunlara uygulanır

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 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.

data
IntPtr

nativeint

Yazacak olay verilerinin işaretçisi.

Döndürülenler

Boolean

Olay true yazılırsa, aksi takdirde 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 .

Şunlara uygulanır