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.
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 -> 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, 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 -> 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, 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[] -> 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, 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.
- 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
