TraceListener Sınıf

Tanım

İzleme ve hata ayıklama çıkışını abstract izleyen dinleyiciler için temel sınıfı sağlar.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Devralma
TraceListener
Devralma
TraceListener
Türetilmiş
Uygulamalar

Açıklamalar

uygulama örnekleri TraceListeneriçin bkz DefaultTraceListener. ve TextWriterTraceListenerEventLogTraceListener sınıfları.

İzleme dinleyicisi kullanmak için izlemeyi veya hata ayıklamayı etkinleştirmeniz gerekir. Aşağıdaki söz dizimi derleyiciye özgüdür. C# veya Visual Basic dışında derleyiciler kullanıyorsanız, derleyicinizin belgelerine bakın.

  • C# dilinde hata ayıklamayı etkinleştirmek için, /d:DEBUG kodunuzu derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyebilirsiniz #define DEBUG . Visual Basic'te bayrağını /d:DEBUG=True derleyici komut satırına ekleyin.

  • C# dilinde izlemeyi etkinleştirmek için kodunuzu /d:TRACE derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyin #define TRACE . Visual Basic'te bayrağını /d:TRACE=True derleyici komut satırına ekleyin.

İzleme dinleyicisi eklemek için, uygulamanızın adına karşılık gelen yapılandırma dosyasını düzenleyin. Bu dosyanın içine bir dinleyici ekleyebilir, türünü ve parametresini ayarlayabilir, dinleyiciyi kaldırabilir veya uygulama tarafından daha önce ayarlanan tüm dinleyicileri temizleyebilirsiniz. Yapılandırma dosyası aşağıdaki örneğe benzer şekilde biçimlendirilmelidir.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

İzleme için yapılandırma dosyalarını kullanma hakkında daha fazla bilgi için bkz <. system.diagnostics>.

Uygulayanlara Notlar

ve Trace sınıfları için özel bir dinleyici uygulamak için bu sınıftan devralınDebug. En azından ve WriteLine(String) yöntemlerini uygulamanız Write(String) gerekir. Ayrıca, Close() ve Flush() yöntemlerini de uygulayabilirsinizFail(String).

Oluşturucular

TraceListener()

TraceListener sınıfının yeni bir örneğini başlatır.

TraceListener(String)

Dinleyici olarak belirtilen adı kullanarak sınıfın TraceListener yeni bir örneğini başlatır.

Özellikler

Attributes

Uygulama yapılandırma dosyasında tanımlanan özel izleme dinleyicisi özniteliklerini alır.

Filter

İzleme dinleyicisi için izleme filtresini alır veya ayarlar.

IndentLevel

Girinti düzeyini alır veya ayarlar.

IndentSize

Girintideki boşlukların sayısını alır veya ayarlar.

IsThreadSafe

İzleme dinleyicisinin iş parçacığı güvenli olup olmadığını belirten bir değer alır.

Name

Bu TraceListeneriçin bir ad alır veya ayarlar.

NeedIndent

Çıkışın girintili olup olmayacağını belirten bir değer alır veya ayarlar.

TraceOutputOptions

İzleme çıkış seçeneklerini alır veya ayarlar.

Yöntemler

Close()

Türetilmiş bir sınıfta geçersiz kılındığında, artık izleme veya hata ayıklama çıkışı almaması için çıkış akışını kapatır.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

TraceListener tarafından kullanılan tüm kaynakları serbest bırakır.

Dispose(Boolean)

TraceListener tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Fail(String)

sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi yayar TraceListener .

Fail(String, String)

Sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi ve ayrıntılı bir hata iletisi yayar TraceListener .

Flush()

Türetilmiş bir sınıfta geçersiz kılındığında çıkış arabelleği temizlenir.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetSupportedAttributes()

İzleme dinleyicisi tarafından desteklenen özel öznitelikleri alır.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

İzleme bilgilerini, veri nesnesini ve olay bilgilerini dinleyiciye özel çıkışa yazar.

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

dinleyiciye özgü çıkışa bir dizi veri nesnesi ve olay bilgisi olan izleme bilgilerini yazar.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar.

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

İzleme bilgilerini, bir iletiyi ve olay bilgilerini dinleyiciye özel çıkışa yazar.

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

Dinleyiciye özgü çıkışa, biçimlendirilmiş bir nesne dizisi ve olay bilgileri olan izleme bilgilerini yazar.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özel çıktıya yazar.

Write(Object)

nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar.

Write(Object, String)

Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesne ToString() yönteminin TraceListener değerini yazar.

Write(String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen iletiyi türetilmiş sınıfta oluşturduğunuz dinleyiciye yazar.

Write(String, String)

Sınıfını uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar.

WriteIndent()

Bu sınıfı uygularken oluşturduğunuz dinleyiciye girintiyi yazar ve özelliğini olarak falsesıfırlarNeedIndent.

WriteLine(Object)

nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLine(Object, String)

Sınıfı uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar ve ardından bir satır sonlandırıcısı yazar.

WriteLine(String)

Türetilmiş bir sınıfta geçersiz kılındığında, türetilmiş sınıfta oluşturduğunuz dinleyiciye bir ileti yazar ve bunu bir satır sonlandırıcısı izler.

WriteLine(String, String)

Sınıfı uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti, ardından bir satır sonlandırıcı yazar.

Şunlara uygulanır

İş Parçacığı Güvenliği

Bu güvenli iş parçacığı türüdür.

Ayrıca bkz.