Aracılığıyla paylaş


TraceSource.TraceEvent Yöntem

Tanım

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
Kaynak:
TraceSource.cs
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

Özel durumlar

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.

Şunlara uygulanır

TraceEvent(TraceEventType, Int32, String)

Kaynak:
TraceSource.cs
Kaynak:
TraceSource.cs
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")]
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

Özel durumlar

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.

Şunlara uygulanır

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

Kaynak:
TraceSource.cs
Kaynak:
TraceSource.cs
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")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params 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

Özel durumlar

format, null değeridir.

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.

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.

Şunlara uygulanır