TraceSource.TraceEvent Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

Koleksiyondaki izleme dinleyicilerine Listeners bir izleme olayı iletisi yazar.

Aşırı Yüklemeler

TraceEvent(TraceEventType, Int32)	Belirtilen olay türünü ve olay tanımlayıcısını kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı iletisi yazar.
TraceEvent(TraceEventType, Int32, String)	Belirtilen olay türünü, olay tanımlayıcısını ve iletiyi kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı iletisi yazar.
TraceEvent(TraceEventType, Int32, String, Object[])	Belirtilen olay türünü, olay tanımlayıcısını ve bağımsız değişken dizisini ve biçimini kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı yazar.

TraceEvent(TraceEventType, Int32)

Kaynak:

TraceSource.cs

Belirtilen olay türünü ve olay tanımlayıcısını kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı iletisi yazar.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parametreler

eventType

TraceEventType

İzleme verilerinin olay türünü belirten numaralandırma değerlerinden biri.

id

Int32

Olayın sayısal tanımlayıcısı.

Öznitelikler

ConditionalAttribute

Özel durumlar

ObjectDisposedException

Sonlandırma sırasında bir olayı izleme girişiminde bulunuldu.

Örnekler

Aşağıdaki kod örneği, izleme olayını dinleyicilere geçirmek için yönteminin kullanımını TraceEvent(TraceEventType, Int32) gösterir. Bu kod örneği, sınıfı için TraceSource sağlanan daha büyük bir örneğin parçasıdır.

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Açıklamalar

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.

yöntemi, TraceEvent özelliği tarafından döndürülen nesnesinin SourceSwitchSwitch yöntemini çağırırShouldTrace. döndürürsetrueShouldTrace, TraceEvent her dinleyicinin karşılık gelen TraceEvent yöntemini çağırır. Aksi takdirde, TraceEvent dinleyicilerin yöntemlerini çağırmadan döndürür.

İzleme içeriği dinleyiciye özgüdür. Yöntem dinleyici uygulaması tarafından geçersiz kılınmazsa, varsayılan çıkış izleme kaynağının adı, sayısal kimliği ve olay türüdür. Ek izleme içeriği dinleyicinin TraceOutputOptions özellik değerine bağlıdır.

Not

Nesne EventLogTraceListener en fazla id 65.535 değeriyle sınırlıdır. id Belirtilen değer 65.535'ten büyükse, EventLogTraceListener 65.535 kullanır.

TraceEvent(TraceEventType, Int32, String)

Kaynak:

TraceSource.cs

Belirtilen olay türünü, olay tanımlayıcısını ve iletiyi kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı iletisi yazar.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parametreler

eventType

TraceEventType

İzleme verilerinin olay türünü belirten numaralandırma değerlerinden biri.

id

Int32

Olayın sayısal tanımlayıcısı.

message

String

Yazacak izleme iletisi.

Öznitelikler

ConditionalAttribute

Özel durumlar

ObjectDisposedException

Sonlandırma sırasında bir olayı izleme girişiminde bulunuldu.

Örnekler

Aşağıdaki kod örneği, izleme olayını dinleyicilere geçirmek için yönteminin kullanımını TraceEvent(TraceEventType, Int32) gösterir. Bu kod örneği, sınıfı için TraceSource sağlanan daha büyük bir örneğin parçasıdır.

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Açıklamalar

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.

yöntemi, TraceEvent özelliği tarafından döndürülen nesnesinin SourceSwitchSwitch yöntemini çağırırShouldTrace. döndürürsetrueShouldTrace, TraceEvent her dinleyicinin karşılık gelen TraceEvent yöntemini çağırır. Aksi takdirde, TraceEvent dinleyicilerin yöntemlerini çağırmadan döndürür.

İzleme içeriği dinleyiciye özgüdür. Yöntem dinleyici uygulaması tarafından geçersiz kılınmazsa, varsayılan çıkış izleme kaynağının adı, sayısal kimliği, olay türü ve iletidir. Ek izleme içeriği dinleyicinin TraceOutputOptions özellik değerine bağlıdır.

Not

Nesne EventLogTraceListener en fazla id 65.535 değeriyle sınırlıdır. id Belirtilen değer 65.535'ten büyükse, EventLogTraceListener nesne 65.535 kullanır.

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

Kaynak:

TraceSource.cs

Belirtilen olay türünü, olay tanımlayıcısını ve bağımsız değişken dizisini ve biçimini kullanarak koleksiyondaki Listeners izleme dinleyicilerine bir izleme olayı yazar.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametreler

eventType

TraceEventType

İzleme verilerinin olay türünü belirten numaralandırma değerlerinden biri.

id

Int32

Olayın sayısal tanımlayıcısı.

format

String

Metin içeren bileşik biçim dizesi, dizideki args nesnelere karşılık gelen sıfır veya daha fazla biçim öğesiyle karıştırılır.

args

Object[]

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

Öznitelikler

ConditionalAttribute

Özel durumlar

ArgumentNullException

format, null değeridir.

FormatException

format geçersizdir.

-veya-

Biçimlendirecek bağımsız değişkeni gösteren sayı sıfırdan küçük veya biçimlendirecek belirtilen nesne sayısından büyük veya buna eşit.

ObjectDisposedException

Sonlandırma sırasında bir olayı izleme girişiminde bulunuldu.

Örnekler

Aşağıdaki kod örneği, izleme olayını dinleyicilere geçirmek için yönteminin kullanımını TraceEvent(TraceEventType, Int32) gösterir. Bu kod örneği, sınıfı için TraceSource sağlanan daha büyük bir örneğin parçasıdır.

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Açıklamalar

parametresi hakkında format daha fazla bilgi için bkz . Bileşik Biçimlendirme.

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.

yöntemi, TraceEvent özelliği tarafından döndürülen nesnesinin SourceSwitchSwitch yöntemini çağırırShouldTrace. döndürürsetrueShouldTrace, TraceEvent her dinleyicinin karşılık gelen TraceEvent yöntemini çağırır. Aksi takdirde, TraceEvent dinleyicilerin yöntemlerini çağırmadan döndürür.

İzleme içeriği dinleyiciye özgüdür. Varsayılan TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) yöntem, izleme üst bilgisine kaynak adı, olay türü ve sayısal kimliği yazar, ardından dizeyi ve diziyi String.Format(IFormatProvider, String, Object[]) geçirerek format ve args dizeyi CultureInfo.InvariantCulture ileti çıkışı olarak biçimlendirmek için özelliğini kullanarak yöntemini çağırır.

Not

Nesne EventLogTraceListener en fazla id 65.535 değeriyle sınırlıdır. id Belirtilen değer 65.535'ten büyükse, EventLogTraceListener nesne 65.535 kullanır.

Ayrıca bkz.

• Bileşik Biçimlendirme
• Standart Sayısal Biçim Dizeleri
• Özel Sayısal Biçim Dizeleri
• Standart DateTime Biçim Dizeleri
• Özel DateTime Biçim Dizeleri
• Sabit Listesi Biçim Dizeleri
• .NET'te Biçimlendirme Türleri