ConsoleTraceListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TextWriterTraceListener.dll

Kaynak:

ConsoleTraceListener.cs

İzleme veya hata ayıklama çıkışını ya standart çıktıya ya da standart hata akışına yönlendirir.

public ref class ConsoleTraceListener : System::Diagnostics::TextWriterTraceListener

public class ConsoleTraceListener : System.Diagnostics.TextWriterTraceListener

type ConsoleTraceListener = class
    inherit TextWriterTraceListener

Public Class ConsoleTraceListener
Inherits TextWriterTraceListener

Devralma

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

ConsoleTraceListener

Örnekler

Aşağıdaki kod örneği, iki ortak yönteme sahip bir sınıftan oluşan bir konsol uygulaması uygular.

yöntemi komut Main satırı bağımsız değişkenlerini inceler ve izleme çıkışının standart hata akışına mı yoksa standart çıkış akışına mı yönlendirileceğini belirler. Mainbelirtilen ConsoleTraceListener çıkış akışı için bir Console nesne oluşturup başlatır ve bu nesneyi izleme dinleyicisi koleksiyonuna ekler. Ardından yürütme ortamı ve izleme dinleyicisi yapılandırması hakkındaki ayrıntıları izleme çıkışına yazan yöntemini çağırır WriteEnvironmentInfoToTrace .

Örnek uygulama çalıştırıldığında, ortam ve izleme yapılandırma ayrıntıları nesnesi aracılığıyla belirtilen konsol çıkış akışına ConsoleTraceListener yazılır.

// Define the TRACE directive, which enables trace output to the
// Trace.Listeners collection. Typically, this directive is defined
// as a compilation argument.
#define TRACE
using System;
using System.Diagnostics;

public class ConsoleTraceSample
{

    // Define a simple method to write details about the current executing
    // environment to the trace listener collection.
    public static void WriteEnvironmentInfoToTrace()
    {

        string methodName = "WriteEnvironmentInfoToTrace";

        Trace.Indent();
        Trace.WriteLine(DateTime.Now.ToString() + " - Start of " + methodName);
        Trace.Indent();

        // Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " + System.Environment.OSVersion.ToString());
        Trace.WriteLine("Computer name: " + System.Environment.MachineName);
        Trace.WriteLine("User name: " + System.Environment.UserName);
        Trace.WriteLine("CLR runtime version: " + System.Environment.Version.ToString());
        Trace.WriteLine("Command line: " + System.Environment.CommandLine);

        // Enumerate the trace listener collection and
        // display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners = " + Trace.Listeners.Count.ToString());

        foreach (TraceListener tl in Trace.Listeners)
        {
            Trace.WriteLine("Trace listener name = " + tl.Name);
            Trace.WriteLine("               type = " + tl.GetType().ToString());
        }

        Trace.Unindent();
        Trace.WriteLine(DateTime.Now.ToString() + " - End of " + methodName);
        Trace.Unindent();
    }

    // Define the main entry point of this class.
    // The main method adds a console trace listener to the collection
    // of configured trace listeners, then writes details on the current
    // executing environment.
    public static void Main(string[] CmdArgs)
    {

        // Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - Start of Main");

        // Define a trace listener to direct trace output from this method
        // to the console.
        ConsoleTraceListener consoleTracer;

        // Check the command line arguments to determine which
        // console stream should be used for trace output.
        if ((CmdArgs.Length>0)&&(CmdArgs[0].ToString().ToLower().Equals("/stderr")))
            // Initialize the console trace listener to write
            // trace output to the standard error stream.
        {
            consoleTracer = new ConsoleTraceListener(true);
        }
        else
        {
            // Initialize the console trace listener to write
            // trace output to the standard output stream.
            consoleTracer = new ConsoleTraceListener();
        }
        // Set the name of the trace listener, which helps identify this
        // particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer";

        // Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Starting output to trace listener.");

        // Add the new console trace listener to
        // the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer);

        // Call a local method, which writes information about the current
        // execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace();

        // Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Ending output to trace listener.");

        // Flush any pending trace messages, remove the
        // console trace listener from the collection,
        // and close the console trace listener.
        Trace.Flush();
        Trace.Listeners.Remove(consoleTracer);
        consoleTracer.Close();

        // Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - End of Main");

        // Close all other configured trace listeners.
        Trace.Close();
    }
}

' Define the TRACE constant, which enables trace output to the 
' Trace.Listeners collection. Typically, this constant is defined
' as a compilation argument.
#Const TRACE = True

Imports System.Diagnostics

Public Class ConsoleTraceSample

    ' Define a simple method to write details about the current executing 
    ' environment to the trace listener collection.
    Public Shared Sub WriteEnvironmentInfoToTrace()

        Dim methodName As String = "WriteEnvironmentInfoToTrace"

        Trace.Indent()
        Trace.WriteLine(DateTime.Now.ToString() & " - Start of " & methodName)
        Trace.Indent()

        ' Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " & _
            System.Environment.OSVersion.ToString())
        Trace.WriteLine("Computer name: " & System.Environment.MachineName)
        Trace.WriteLine("User name: " & System.Environment.UserName)
        Trace.WriteLine("CLR version: " & System.Environment.Version.ToString)
        Trace.WriteLine("Command line: " & System.Environment.CommandLine)

        ' Enumerate the trace listener collection and 
        ' display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners = " & _
            Trace.Listeners.Count.ToString())

        Dim tl As TraceListener
        For Each tl In Trace.Listeners
            Trace.WriteLine("Trace listener name = " & tl.Name)
            Trace.WriteLine("               type = " & tl.GetType().ToString())
        Next tl

        Trace.Unindent()
        Trace.WriteLine(DateTime.Now.ToString() & " - End of " & methodName)
        Trace.Unindent()

    End Sub

    ' Define the main entry point of this class.
    ' The main method adds a console trace listener to the collection
    ' of configured trace listeners, then writes details on the current
    ' executing environment.
    Public Shared Sub Main(ByVal CmdArgs() As String)

        ' Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() & " - Start of Main")

        ' Define a trace listener to direct trace output from this method
        ' to the console.
        Dim consoleTracer As ConsoleTraceListener

        ' Check the command line arguments to determine which
        ' console stream should be used for trace output.
        If (CmdArgs.Length > 0) AndAlso _
           (CmdArgs(0).ToLower.Equals("/stderr")) Then
            ' Initialize the console trace listener to write
            ' trace output to the standard error stream.
            consoleTracer = New ConsoleTraceListener(True)
        Else
            ' Initialize the console trace listener to write
            ' trace output to the standard output stream.
            consoleTracer = New ConsoleTraceListener
        End If
        ' Set the name of the trace listener, which helps identify this 
        ' particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer"

        ' Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & " [" & _
             consoleTracer.Name & "] - Starting output to trace listener.")

        ' Add the new console trace listener to 
        ' the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer)

        ' Call a local method, which writes information about the current 
        ' execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace()

        ' Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & " [" & _
            consoleTracer.Name & "] - Ending output to trace listener.")

        ' Flush any pending trace messages, remove the 
        ' console trace listener from the collection,
        ' and close the console trace listener.
        Trace.Flush()
        Trace.Listeners.Remove(consoleTracer)
        consoleTracer.Close()

        ' Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - End of Main")

        ' Close all other configured trace listeners.
        Trace.Close()

    End Sub

End Class

Açıklamalar

ConsoleTraceListener izleme ve hata ayıklama iletilerini konsola yazmak için sınıfını kullanın. Akışa veya akışa izleme iletileri ConsoleTraceListener yazmak için Console.Out bir Console.Error nesne başlatabilirsiniz.

Important

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 atmak içinDisposetry/ 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.

İzleme ve hata ayıklama çıkışı etkinleştirildiğinde, ConsoleTraceListener iletiler belirtilen System.Console akışa yazılır ve bu, iletilerin veya Console.Write yöntemleriyle yazılmasıyla Console.WriteLine benzerdir. Konsol uygulamasında çıkış System.Console ve hata akışları iletileri var olan konsol penceresine yazar veya akışları bir System.IO.TextWriter örneğe yazmak üzere yeniden yönlendirebilirsiniz.

Note

konsol yoksa, Windows tabanlı bir uygulamada olduğu gibi konsola yazılan iletiler görüntülenmez.

İletilerin , ConsoleTraceListenerveya konsola Listenersyazılmasını istiyorsanız, uygun Trace koleksiyona bir TraceSource nesne Debug ekleyin. Ayrıca, veya Trace.Write yöntemlerini kullanarak iletileri doğrudan konsola Trace.WriteLine yazabilirsiniz.

Note

Debug ve Trace sınıfları, ilgili TraceListenerCollection özellikleri aracılığıyla erişilen aynı Listeners koleksiyonu paylaşır. Bu sınıflardan birini kullanarak koleksiyona bir ConsoleTraceListener nesne eklerseniz, diğer sınıf otomatik olarak aynı dinleyiciyi kullanır.

Çoğu derleyici, koşullu derleme bayrakları aracılığıyla izleme ve hata ayıklama çıkışını etkinleştirir. İzlemeyi veya hata ayıklamayı etkinleştirmezseniz, ve System.Diagnostics.Debug sınıfları aracılığıyla System.Diagnostics.Trace yazılan iletiler etkili bir şekilde yoksayılır. İzleme ve hata ayıklama çıkışını etkinleştirmek için 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 kodunuzu derlerken derleyici komut satırına /d:DEBUGbayrağını ekleyin veya dosyanızın en üstüne #define DEBUG ekleyebilirsiniz. Visual Basic /d:DEBUG=True bayrağını derleyici komut satırına ekleyin.

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

Kodunuzda koleksiyona ConsoleTraceListener bir Listeners nesne ekleyebilirsiniz. .NET Framework uygulamaları için uygulama yapılandırma dosyası aracılığıyla ConsoleTraceListener koleksiyonuna bir Listeners nesnesi ekleyebilirsiniz. ConsoleTraceListener Belirli bir kod bölümü veya yürütme yolu için ileti yazmak için kodunuzdaki nesneyi ekleyin. ConsoleTraceListener Uygulama yürütülürken tüm izleme ve hata ayıklama iletilerini konsola yönlendirmek için uygulamayı yapılandırma dosyanıza nesnesini ekleyin.

Belirli bir kod bölümü için konsola izleme ve hata ayıklama iletileri yazmak için bir ConsoleTraceListener nesne başlatın ve bunu koleksiyona Listeners ekleyin. veya Trace sınıflarını kullanarak Debug iletileri içeren kod bölümünü izleme. Kod bölümünün sonunda, nesnesini koleksiyondan kaldırın ve üzerinde yöntemini çağırınConsoleTraceListenerListeners.CloseConsoleTraceListener

.NET Framework uygulamaları için, uygulama yürütülürken tüm izleme ve hata ayıklama iletilerini konsola yönlendirmek için, uygulama yapılandırma dosyasına bir ConsoleTraceListener nesnesi ekleyin. Aşağıdaki örnek, adlı bir ConsoleTraceListener nesneyi configConsoleListener koleksiyona Listeners ekler.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="configConsoleListener" type="System.Diagnostics.ConsoleTraceListener" />
      </listeners>
    </trace>
  </system.diagnostics>
 </configuration>

Uygulama yapılandırma dosyasına izleme dinleyicileri ekleme hakkında ayrıntılı bilgi için bkz <. dinleyiciler>.

Oluşturucular

Name	Description
ConsoleTraceListener()	Standart çıkış akışına ConsoleTraceListener yazılan izleme çıkışı ile sınıfının yeni bir örneğini başlatır.
ConsoleTraceListener(Boolean)	Standart çıkış akışına veya standart hata akışına ConsoleTraceListener izleme çıkışı yazma seçeneğiyle sınıfını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. (Devralındığı yer: TextWriterTraceListener)

Yöntemler

Name	Description
Close()	Çıktıyı bu izleme dinleyicisi için belirtilen akışa kapatır.
Dispose()	tarafından TraceListenerkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TraceListener)
Dispose(Boolean)	Bu TextWriterTraceListener nesneyi atar. (Devralındığı yer: TextWriterTraceListener)
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. (Devralındığı yer: TextWriterTraceListener)
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. (Devralındığı yer: TextWriterTraceListener)
WriteIndent()	Girintiyi, bu sınıfı uygularken oluşturduğunuz dinleyiciye yazar ve özelliğini olarak NeedIndentsıfırlarfalse. (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). (Devralındığı yer: TextWriterTraceListener)

Ayrıca bkz.

• TraceListener
• TextWriterTraceListener
• Debug
• Trace
• Console