ConsoleTraceListener Sınıf

Tanım

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önlendirilmesi gerektiğini belirler. Mainbelirtilen Console çıkış akışı için bir ConsoleTraceListener 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 Console.Out yazmak için Console.Error bir ConsoleTraceListener nesne başlatabilirsiniz.

İzleme ve hata ayıklama çıkışı etkinleştirildiğinde, ConsoleTraceListener iletiler belirtilen System.Console akışa yazılır ve bu da iletilerin veya Console.WriteLine yöntemleriyle Console.Write yazıldığı yönteme benzer. 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.

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

Ç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.Trace sınıfları aracılığıyla System.Diagnostics.Debug 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'te derleyici komut satırına /d:DEBUG=True bayrağını 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'te derleyici komut satırına /d:TRACE=True bayrağını ekleyin.

Kodunuzda koleksiyona Listeners nesne ConsoleTraceListener ekleyebilirsiniz. Dilerseniz .NET Framework uygulamalar için uygulama yapılandırma dosyası aracılığıyla koleksiyona Listeners bir ConsoleTraceListener nesne ekleyebilirsiniz. ConsoleTraceListener Belirli bir kod bölümü veya yürütme yolu için ileti yazmak için kodunuza nesnesini 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 Debug sınıflarını kullanarak Trace kodun iletileri içeren bölümünü izleme. Kod bölümünün sonunda, nesnesini koleksiyonundan kaldırın ve üzerinde yöntemini çağırınConsoleTraceListenerClose.ConsoleTraceListenerListeners

.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 nesne 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

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• TraceListener
• TextWriterTraceListener
• Debug
• Trace
• Console