TextWriterTraceListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 kullanan StreamWriter 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.

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 IDisposable arabirimini uygular. Kullanımını bitirdiğinizde, doğrudan ya da dolaylı yoldan atmalısınız. Türü doğrudan atabilmek için, bir Disposetry/ bloğunda catch yöntemini çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi 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 çıkışı almaması için CloseWriter , için çıkış arabelleğine FlushWriterve WriteWriteriletisine yönelik yöntemleri 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, 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 .

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 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 ö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>

Uyarı

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

Oluşturucular

Name	Description
TextWriterTraceListener()	ile sınıfının TextWriter yeni bir örneğini TextWriterTraceListener çıkış alıcısı olarak 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 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(String, String)	Hata ayıklama ve izleme çıkışının TextWriterTraceListener alıcısı olarak dosyasını kullanarak belirtilen adla sınıfı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(TextWriter, String)	İ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 belirtilen adla 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.

Özellikler

Name	Description
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şluk 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 çıktısı 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

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

Ayrıca bkz.

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