TraceListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.TraceSource.dll

Kaynak:

TraceListener.cs

İ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 abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

Devralma

Object

MarshalByRefObject

TraceListener

Türetilmiş

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

Uygulamalar

IDisposable

Açıklamalar

uygulama örnekleri TraceListeneriçin bkz DefaultTraceListener. , TextWriterTraceListener ve EventLogTraceListener 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, derleyici komut satırına bayrağını ekleyin /d:DEBUG=True .

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

İzleme dinleyicisi eklemek için uygulamanızın adına karşılık gelen yapılandırma dosyasını düzenleyin. Bu dosya içinde bir dinleyici ekleyebilir, türünü ayarlayabilir ve parametresini ayarlayabilir, bir 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 Debug sınıfları için özel bir dinleyici uygulamak için bu sınıftan Trace devralın. En azından ve Write(String) yöntemlerini uygulamanız WriteLine(String) gerekir. Ayrıca, Fail(String) ve Close() yöntemlerini uygulayabilirsinizFlush().

Oluşturucular

Name	Description
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 yeni bir örneğini TraceListener başlatır.

Özellikler

Name	Description
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şluk 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ışı girintileyip girintilemeyeceğini belirten bir değer alır veya ayarlar.
TraceOutputOptions	İzleme çıktısı seçeneklerini alır veya ayarlar.

Yöntemler

Name	Description
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.
Dispose()	tarafından TraceListenerkullanılan tüm kaynakları serbest bırakır.
Dispose(Boolean)	tarafından TraceListener kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Fail(String, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi ve ayrıntılı bir hata iletisi yayar TraceListener .
Fail(String)	Sınıfını uygularken oluşturduğunuz dinleyiciye 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()	Geçerli örneğin Type 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 Objectbasit 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 bir dize döndürür. (Devralındığı yer: Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	dinleyiciye özgü çıkışa izleme bilgileri, veri nesnesi ve olay bilgileri yazar.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	dinleyiciye özgü çıkışa izleme bilgileri, bir dizi veri nesnesi ve olay bilgisi yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	dinleyiciye özgü çıkışa, biçimlendirilmiş bir nesne dizisi ve olay bilgileri olan izleme bilgilerini yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	dinleyiciye özgü çıkışa izleme bilgileri, ileti ve olay bilgileri yazar.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özgü çıkışa 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(Object)	sınıfını uygularken oluşturduğunuz dinleyiciye nesnesinin ToString() yönteminin TraceListener değerini yazar.
Write(String, String)	Sınıfını uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti 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.
WriteIndent()	Girintiyi, bu sınıfı uygularken oluşturduğunuz dinleyiciye yazar ve özelliğini olarak NeedIndentsıfırlarfalse.
WriteLine(Object, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini ve ardından bir satır sonlandırıcı yazar.
WriteLine(Object)	sınıfını uyguladığınızda oluşturduğunuz dinleyiciye nesnesinin ToString() yönteminin TraceListener değerini yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLine(String, String)	Sınıfı uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti 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 ve ardından bir satır sonlandırıcı yazar.

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

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

Ayrıca bkz.

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <system.diagnostics> Öğesi