TextWriterTraceListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TextWriterTraceListener.dll

Kaynak:

TextWriterTraceListener.cs

İzleme veya hata ayıklama çıkışını gibi FileStreambir TextWriterStreamveya öğesine yönlendirir.

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Devralma

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Türetilmiş

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Örnekler

Aşağıdaki örnek, adlı bir dosyaya TextWriterTraceListener yazmak için adlı myOutputWriter öğesini StreamWriter kullanan sınıfının bir örneğini uygular.TestFile.txt İlk olarak örnek çıktı için bir dosya oluşturur. Ardından ilk metin yazıcısı için öğesini StreamWriter oluşturur, çıkış dosyasını atar ve dosyasına ekler Listeners. Ardından kod, dosyaya bir satır metin çıkışı verir. Son olarak, örnek çıkış arabelleği temizler.

Bu örneği çalıştırdıktan sonra çıktıyı TestFile.txt görmek için dosyayı açabilirsiniz.

void main()
{
   #if defined(TRACE)
   // Create a file for output named TestFile.txt.
   Stream^ myFile = File::Create( "TestFile.txt" );
   
   // Create a new text writer using the output stream and
   // add it to the trace listeners.
   TextWriterTraceListener^ myTextListener = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Açıklamalar

sınıfı, TextWriterTraceListener izleme veya hata ayıklama çıkışını Writer alan metin yazıcısını almak veya ayarlamak için özelliğini sağlar.

Önemli

Bu tür arabirimini IDisposable uygular. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için yöntemini bir try/catch blok içinde çağırın.Dispose Bunu dolaylı olarak atmak için (C#'de) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için arabirim konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

Bu sınıf, artık izleme veya hata ayıklama çıktısı almaması için, için çıkış arabelleğine WriterFlush ve WriterWrite iletisine yöntemleri CloseWriter de sağlar.

İ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, /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, bayrağını /d:TRACE=True derleyici komut satırına ekleyin.

bir .NET Framework uygulamasına izleme 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 örnekte olduğu gibi 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>  

Not

Kullanımda olan veya kullanılamayan bir dosyaya yazma girişiminde bulunulduysa, dosya adına otomatik olarak bir GUID ön eki eklenir.

Oluşturucular

TextWriterTraceListener()	Çıkış alıcısı TextWriterTraceListener olarak ile TextWriter sınıfının yeni bir örneğini başlatır.
TextWriterTraceListener(Stream)	Hata ayıklama ve izleme çıkışının TextWriterTraceListener alıcısı olarak akışı kullanarak sınıfının yeni bir örneğini başlatır.
TextWriterTraceListener(Stream, String)	Hata ayıklama ve izleme çıkışının TextWriterTraceListener alıcısı olarak akışı kullanarak belirtilen adla sınıfının yeni bir örneğini başlatır.
TextWriterTraceListener(String)	Hata ayıklama ve izleme çıkışının TextWriterTraceListener alıcısı olarak dosyasını kullanarak sınıfının yeni bir örneğini başlatır.
TextWriterTraceListener(String, String)	Hata ayıklama ve izleme çıkışının TextWriterTraceListener alıcısı olarak dosyasını kullanarak belirtilen adla sınıfının yeni bir örneğini başlatır.
TextWriterTraceListener(TextWriter)	İzleme veya hata ayıklama çıkışının TextWriterTraceListener alıcısı olarak belirtilen yazıcıyı kullanarak sınıfın yeni bir örneğini başlatır.
TextWriterTraceListener(TextWriter, String)	İzleme veya hata ayıklama çıkışının TextWriterTraceListener alıcısı olarak belirtilen yazıcıyı kullanarak belirtilen adla sınıfın yeni bir örneğini başlatır.

Özellikler

Attributes	Uygulama yapılandırma dosyasında tanımlanan özel izleme dinleyicisi özniteliklerini alır. (Devralındığı yer: TraceListener)
Filter	İzleme dinleyicisi için izleme filtresini alır veya ayarlar. (Devralındığı yer: TraceListener)
IndentLevel	Girinti düzeyini alır veya ayarlar. (Devralındığı yer: TraceListener)
IndentSize	Girintideki boşlukların sayısını alır veya ayarlar. (Devralındığı yer: TraceListener)
IsThreadSafe	İzleme dinleyicisinin iş parçacığı güvenli olup olmadığını belirten bir değer alır. (Devralındığı yer: TraceListener)
Name	Bu TraceListeneriçin bir ad alır veya ayarlar. (Devralındığı yer: TraceListener)
NeedIndent	Çıkışı girintileyip girintilemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: TraceListener)
TraceOutputOptions	İzleme çıkışı seçeneklerini alır veya ayarlar. (Devralındığı yer: TraceListener)
Writer	İzleme veya hata ayıklama çıkışını alan metin yazıcısını alır veya ayarlar.

Yöntemler

Close()	artık izleme veya hata ayıklama çıkışı almaması için öğesini Writer 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. (Devralındığı yer: TraceListener)
Dispose(Boolean)	Bu TextWriterTraceListener nesneyi atar.
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 . (Devralındığı yer: 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 . (Devralındığı yer: TraceListener)
Flush()	için çıkış arabelleği temizler Writer.
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. (Devralındığı yer: TraceListener)
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 çıktıya yazar. (Devralındığı yer: TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	İzleme bilgilerini, bir veri nesneleri dizisini ve olay bilgilerini dinleyiciye özel çıktıya yazar. (Devralındığı yer: TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar. (Devralındığı yer: TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	İzleme bilgilerini, bir iletiyi ve olay bilgilerini dinleyiciye özel çıkışa yazar. (Devralındığı yer: TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Dinleyiciye özgü çıktıya, biçimlendirilmiş bir nesne dizisi ve olay bilgileri olan izleme bilgilerini yazar. (Devralındığı yer: TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özel çıktıya yazar. (Devralındığı yer: TraceListener)
Write(Object)	nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar. (Devralındığı yer: TraceListener)
Write(Object, String)	Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar. (Devralındığı yer: TraceListener)
Write(String)	Bu örneğin Writeröğesine bir ileti yazar.
Write(String, String)	Sınıfını uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar. (Devralındığı yer: TraceListener)
WriteIndent()	Bu sınıfı uygularken oluşturduğunuz dinleyiciye girintiyi yazar ve özelliğini olarak falsesıfırlarNeedIndent. (Devralındığı yer: TraceListener)
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ı yazar. (Devralındığı yer: TraceListener)
WriteLine(Object, String)	Sınıfını 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. (Devralındığı yer: TraceListener)
WriteLine(String)	Bu örneğe Writer bir ileti yazar ve ardından bir satır sonlandırıcısı yazar. Varsayılan satır sonlandırıcısı, satır beslemesi (\r\n) tarafından izlenen bir satır başıdır.
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. (Devralındığı yer: TraceListener)

Ayrıca bkz.

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace