TraceSource.TraceEvent Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Listeners koleksiyonundaki izleme dinleyicilerine 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 Listeners koleksiyonundaki 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 Listeners koleksiyonundaki 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 Listeners koleksiyonundaki 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 Listeners koleksiyonundaki 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 -> unitPublic 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, dinleyicilere izleme olayı geçirmek için TraceEvent(TraceEventType, Int32) yönteminin kullanımını gösterir. Bu kod örneği, TraceSource sınıfı için 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.
TraceEvent yöntemi, Switch özelliği tarafından döndürülen SourceSwitch nesnesinin ShouldTrace yöntemini çağırır.
ShouldTrace
truedöndürürse, TraceEvent her dinleyicinin ilgili 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
EventLogTraceListener nesnesi en fazla 65.535 id değeriyle sınırlıdır. Belirtilen id değeri 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 Listeners koleksiyonundaki 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 -> unitPublic 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, dinleyicilere izleme olayı geçirmek için TraceEvent(TraceEventType, Int32) yönteminin kullanımını gösterir. Bu kod örneği, TraceSource sınıfı için 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.
TraceEvent yöntemi, Switch özelliği tarafından döndürülen SourceSwitch nesnesinin ShouldTrace yöntemini çağırır.
ShouldTrace
truedöndürürse, TraceEvent her dinleyicinin ilgili 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
EventLogTraceListener nesnesi en fazla 65.535 id değeriyle sınırlıdır. Belirtilen id değeri 65.535'ten büyükse, EventLogTraceListener nesnesi 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 Listeners koleksiyonundaki 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[] -> unitPublic 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, args dizisindeki nesnelere karşılık gelen sıfır veya daha fazla biçim öğesiyle karıştırılır.
- args
- Object[]
Biçimlendirilmesi gereken sıfır veya daha fazla nesne içeren bir object dizisi.
- Öznitelikler
Özel durumlar
format
null.
format geçersiz.
-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, dinleyicilere izleme olayı geçirmek için TraceEvent(TraceEventType, Int32) yönteminin kullanımını gösterir. Bu kod örneği, TraceSource sınıfı için 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
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.
TraceEvent yöntemi, Switch özelliği tarafından döndürülen SourceSwitch nesnesinin ShouldTrace yöntemini çağırır.
ShouldTrace
truedöndürürse, TraceEvent her dinleyicinin ilgili 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öntemi, izleme üst bilgisine kaynak adı, olay türü ve sayısal kimliği yazar, ardından format dizesini ve args dizisini geçirerek ve dizeyi ileti çıkışı olarak biçimlendirmek için CultureInfo.InvariantCulture özelliğini kullanarak String.Format(IFormatProvider, String, Object[]) yöntemini çağırır.
Not
EventLogTraceListener nesnesi en fazla 65.535 id değeriyle sınırlıdır. Belirtilen id değeri 65.535'ten büyükse, EventLogTraceListener nesnesi 65.535 kullanır.
Ayrıca bkz.
- Bileşik Biçimlendirme
- Standart Sayısal Biçim Dizelerini
- Özel Sayısal Biçim Dizeleri
- Standart DateTime Biçim Dizelerini
- Özel DateTime Biçim Dizelerini
- Numaralandırma Biçim Dizeleri
- .NET'da
Biçimlendirme Türleri
