ConsoleTraceListener Sınıf

Tanım

İzleme veya hata ayıklama çıkışını standart çıkışa veya 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

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

Ö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 birtry/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.

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

Not

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

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

Not

Debug ve Trace sınıfları, ilgili Listeners özellikleri aracılığıyla erişilen aynı TraceListenerCollection 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.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

ConsoleTraceListener()

Standart çıkış akışına ConsoleTraceListener yazılan izleme çıkışıyla 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

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.

(Devralındığı yer: TextWriterTraceListener)

Yöntemler

Close()

Bu izleme dinleyicisi için belirtilen akışa çıkışı kapatır.

Close()

artık izleme veya hata ayıklama çıkışı almaması için öğesini Writer kapatır.

(Devralındığı yer: TextWriterTraceListener)
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.

(Devralındığı yer: TextWriterTraceListener)
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.

(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()

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.

(Devralındığı yer: TextWriterTraceListener)
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.

(Devralındığı yer: TextWriterTraceListener)
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)

Şunlara uygulanır

Ayrıca bkz.