EventLogTraceListener.TraceEvent Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Olay izleme bilgilerini olay günlüğüne yazar.

Aşırı Yüklemeler

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	İzleme bilgilerini, iletiyi ve olay bilgilerini olay günlüğüne yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	İzleme bilgilerini, biçimlendirilmiş bir nesne dizisini ve olay bilgilerini olay günlüğüne yazar.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Kaynak:

EventLogTraceListener.cs

İzleme bilgilerini, iletiyi ve olay bilgilerini olay günlüğüne yazar.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

Parametreler

eventCache

TraceEventCache

Geçerli işlem kimliğini, iş parçacığı kimliğini ve yığın izleme bilgilerini içeren bir nesne.

source

String

Çıkışı tanımlamak için kullanılan ad; genellikle izleme olayını oluşturan uygulamanın adıdır.

severity

TraceEventType

İzlemeye neden olan olayın türünü belirten numaralandırma değerlerinden biri.

id

Int32

Olayın sayısal tanımlayıcısı. ve id birleşimi source bir olayı benzersiz olarak tanımlar.

message

String

İzleme iletisi.

Öznitelikler

ComVisibleAttribute

Özel durumlar

ArgumentException

source belirtilmemiş.

-veya-

Günlük giriş dizesi 32.766 karakteri aşıyor.

Açıklamalar

Önemli

Yöntemlerin TraceEvent uygulama kodu tarafından çağrılması amaçlanmamıştır. Bu yöntemler, izleme verileri yazmak için , Traceve TraceSource sınıflarının Debugyöntemleri tarafından çağrılır.

TraceEvent yöntemi, araçlar tarafından otomatik olarak işlenebilen olayları izlemek için tasarlanmıştır. Örneğin bir izleme aracı, belirli bir olay belirli bir kaynak tarafından izlenirse yöneticiyi bilgilendirebilir.

eventCache ve source parametreleri, olayın izlenip izlenmediğini belirlemek için kullanılır. idbir EventInstance nesnesi oluşturmak için kullanılır ve TraceEventType özelliği için EntryType ile EventLogEntryType eşitleştirilir. EventInstance yöntemi kullanılarak WriteEvent verilerle message olay günlüğüne yazılır.

Not

Parametrenin id en yüksek değeri 65.535'tir. id Belirtilen değer 65.535'ten büyükse, en büyük değer kullanılır.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Kaynak:

EventLogTraceListener.cs

İzleme bilgilerini, biçimlendirilmiş bir nesne dizisini ve olay bilgilerini olay günlüğüne yazar.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametreler

eventCache

TraceEventCache

Geçerli işlem kimliğini, iş parçacığı kimliğini ve yığın izleme bilgilerini içeren bir nesne.

source

String

Çıkışı tanımlamak için kullanılan ad; genellikle izleme olayını oluşturan uygulamanın adıdır.

severity

TraceEventType

İzlemeye neden olan olayın türünü belirten numaralandırma değerlerinden biri.

id

Int32

Olayın sayısal tanımlayıcısı. ve id birleşimi source bir olayı benzersiz olarak tanımlar.

format

String

Dizideki args nesnelere karşılık gelen sıfır veya daha fazla biçim öğesi içeren bir biçim dizesi.

args

Object[]

object Biçimlendirilmesi gereken sıfır veya daha fazla nesne içeren bir dizi.

Öznitelikler

ComVisibleAttribute

Özel durumlar

ArgumentException

source belirtilmemiş.

-veya-

Günlük giriş dizesi 32.766 karakteri aşıyor.

Açıklamalar

Önemli

Yöntemlerin TraceEvent uygulama kodu tarafından çağrılması amaçlanmamıştır. Bu yöntemler, izleme verileri yazmak için , Traceve TraceSource sınıflarının Debugyöntemleri tarafından çağrılır.

TraceEvent yöntemi, araçlar tarafından otomatik olarak işlenebilen olayları izlemek için tasarlanmıştır. Örneğin bir izleme aracı, belirli bir olay belirli bir kaynak tarafından izlenirse yöneticiyi bilgilendirebilir.

eventCache ve source parametreleri, olayın izlenip izlenmediğini belirlemek için kullanılır. idbir EventInstance nesnesi oluşturmak için kullanılır ve TraceEventType özelliği için EntryType ile EventLogEntryType eşitleştirilir. EventInstance, ve args parametrelerinden format alınan iletiyle yöntemi kullanılarak WriteEvent olay günlüğüne yazılır. args nesne dizisi yöntemi kullanılarak Format dizeye dönüştürülür ve dizeyi olay günlüğünün format iletisi olarak biçimlendirmek için dize ve args dizi geçirilir.

Not

Parametrenin id en yüksek değeri 65.535'tir. id Belirtilen değer 65.535'ten büyükse, en büyük değer kullanılır.