DefaultTraceListener Klasse

Definition

Stellt die Standardmethoden für die Ausgabe und das Standardverhalten für die Ablaufverfolgung bereit.Provides the default output methods and behavior for tracing.

public ref class DefaultTraceListener : System::Diagnostics::TraceListener
[System.Runtime.InteropServices.ComVisible(false)]
public class DefaultTraceListener : System.Diagnostics.TraceListener
type DefaultTraceListener = class
    inherit TraceListener
Public Class DefaultTraceListener
Inherits TraceListener
Vererbung
DefaultTraceListener
Attribute

Beispiele

Im folgenden Codebeispiel werden binomiale Koeffizienten berechnet, bei denen es sich um Werte handelt, die in Wahrscheinlichkeit und Statistik verwendet werden.The following code example calculates binomial coefficients, which are values used in probability and statistics. In diesem Beispiel wird DefaultTraceListener ein verwendet, um Ergebnisse und Protokollfehler zu verfolgen.This example uses a DefaultTraceListener to trace results and log errors. Er erstellt einen neuen DefaultTraceListener, fügt ihn der Trace.Listeners Auflistung hinzu und legt die LogFileName -Eigenschaft auf die in den Befehlszeilen Argumenten angegebene Protokolldatei fest.It creates a new DefaultTraceListener, adds it to the Trace.Listeners collection, and sets the LogFileName property to the log file specified in the command-line arguments.

Wenn bei der Verarbeitung des Eingabe Parameters ein Fehler erkannt wird oder wenn die CalcBinomial Funktion eine Ausnahme auslöst, protokolliert Fail die Methode eine Fehlermeldung und zeigt diese an.If an error is detected while processing the input parameter, or if the CalcBinomial function throws an exception, the Fail method logs and displays an error message. Wenn die AssertUiEnabled -Eigenschaft falseist, wird die Fehlermeldung auch in die Konsole geschrieben.If the AssertUiEnabled property is false, the error message is also written to the console. Wenn das Ergebnis erfolgreich berechnet wird, Write(String) schreiben die-Methode und die- WriteLine(String) Methode die Ergebnisse in die Protokolldatei.When the result is calculated successfully, the Write(String) and WriteLine(String) methods write the results to the log file.

Die FailMethoden Write, und WriteLine bewirken, dass Ablauf Verfolgungs Informationen nur in den DefaultTraceListenergeschrieben werden.The Fail, Write, and WriteLine methods cause trace information to be written only to the DefaultTraceListener. Um Ablauf Verfolgungs Informationen in alle Listener in der Trace.Listeners Auflistung zu schreiben, Failverwenden WriteSie die WriteLine Methoden, und Trace der-Klasse.To write trace information to all listeners in the Trace.Listeners collection, use the Fail, Write, and WriteLine methods of the Trace class.

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class Binomial
{

    // args(0) is the number of possibilities for binomial coefficients.
    // args(1) is the file specification for the trace log file.
    public static void Main(string[] args)
    {

        decimal possibilities;
        decimal iter;

        // Remove the original default trace listener.
        Trace.Listeners.RemoveAt(0);

        // Create and add a new default trace listener.
        DefaultTraceListener defaultListener;
        defaultListener = new DefaultTraceListener();
        Trace.Listeners.Add(defaultListener);

        // Assign the log file specification from the command line, if entered.
        if (args.Length>=2)
        {
            defaultListener.LogFileName = args[1];
        }

        // Validate the number of possibilities argument.
        if (args.Length>=1)

            // Verify that the argument is a number within the correct range.
        {
            try
            {
                const decimal MAX_POSSIBILITIES = 99;
                possibilities = Decimal.Parse(args[0]);
                if (possibilities<0||possibilities>MAX_POSSIBILITIES)
                {
                    throw new Exception(String.Format("The number of possibilities must " +
                        "be in the range 0..{0}.", MAX_POSSIBILITIES));
                }
            }
            catch(Exception ex)
            {
                string failMessage = String.Format("\"{0}\" " +
                    "is not a valid number of possibilities.", args[0]);
                defaultListener.Fail(failMessage, ex.Message);
                if (!defaultListener.AssertUiEnabled)
                {
                    Console.WriteLine(failMessage+ "\n" +ex.Message);
                }
                return;
            }
        }
        else
        {
            // Report that the required argument is not present.
            const string ENTER_PARAM = "Enter the number of " +
                      "possibilities as a command line argument.";
            defaultListener.Fail(ENTER_PARAM);
            if (!defaultListener.AssertUiEnabled)
            {
                Console.WriteLine(ENTER_PARAM);
            }
            return;
        }

        for(iter=0; iter<=possibilities; iter++)
        {
            decimal result;
            string binomial;

            // Compute the next binomial coefficient and handle all exceptions.
            try
            {
                result = CalcBinomial(possibilities, iter);
            }
            catch(Exception ex)
            {
                string failMessage = String.Format("An exception was raised when " +
                    "calculating Binomial( {0}, {1} ).", possibilities, iter);
                defaultListener.Fail(failMessage, ex.Message);
                if (!defaultListener.AssertUiEnabled)
                {
                    Console.WriteLine(failMessage+ "\n" +ex.Message);
                }
                return;
            }

            // Format the trace and console output.
            binomial = String.Format("Binomial( {0}, {1} ) = ", possibilities, iter);
            defaultListener.Write(binomial);
            defaultListener.WriteLine(result.ToString());
            Console.WriteLine("{0} {1}", binomial, result);
        }
    }

    public static decimal CalcBinomial(decimal possibilities, decimal outcomes)
    {

        // Calculate a binomial coefficient, and minimize the chance of overflow.
        decimal result = 1;
        decimal iter;
        for(iter=1; iter<=possibilities-outcomes; iter++)
        {
            result *= outcomes+iter;
            result /= iter;
        }
        return result;
    }
}
Imports System.Diagnostics

Module Binomial

    ' args(0) is the number of possibilities for binomial coefficients.
    ' args(1) is the file specification for the trace log file.
    Sub Main(ByVal args() As String)

        Dim possibilities As Decimal
        Dim iter As Decimal

        ' Remove the original default trace listener.
        Trace.Listeners.RemoveAt(0)

        ' Create and add a new default trace listener.
        Dim defaultListener As DefaultTraceListener
        defaultListener = New DefaultTraceListener
        Trace.Listeners.Add(defaultListener)

        ' Assign the log file specification from the command line, if entered.
        If args.Length >= 2 Then
            defaultListener.LogFileName = args(1)
        End If

        ' Validate the number of possibilities argument.
        If args.Length >= 1 Then

            ' Verify that the argument is a number within the correct range.
            Try
                Const MAX_POSSIBILITIES As Decimal = 99
                possibilities = Decimal.Parse(args(0))
                If possibilities < 0 Or possibilities > MAX_POSSIBILITIES Then
                    Throw New Exception( _
                        String.Format("The number of possibilities must " & _
                            "be in the range 0..{0}.", MAX_POSSIBILITIES))
                End If
            Catch ex As Exception
                Dim failMessage As String = String.Format("""{0}"" " & _
                    "is not a valid number of possibilities.", args(0))
                defaultListener.Fail(failMessage, ex.Message)
                If Not defaultListener.AssertUiEnabled Then
                    Console.WriteLine(failMessage & vbCrLf & ex.Message)
                End If
                Return
            End Try
        Else
            ' Report that the required argument is not present.
            Const ENTER_PARAM As String = "Enter the number of " & _
                "possibilities as a command line argument."
            defaultListener.Fail(ENTER_PARAM)
            If Not defaultListener.AssertUiEnabled Then
                Console.WriteLine(ENTER_PARAM)
            End If
            Return
        End If

        For iter = 0 To possibilities
            Dim result As Decimal
            Dim binomial As String

            ' Compute the next binomial coefficient and handle all exceptions.
            Try
                result = CalcBinomial(possibilities, iter)
            Catch ex As Exception
                Dim failMessage As String = String.Format( _
                        "An exception was raised when " & _
                        "calculating Binomial( {0}, {1} ).", _
                        possibilities, iter)
                defaultListener.Fail(failmessage, ex.Message)
                If Not defaultListener.AssertUiEnabled Then
                    Console.WriteLine(failMessage & vbCrLf & ex.Message)
                End If
                Return
            End Try

            ' Format the trace and console output.
            binomial = String.Format("Binomial( {0}, {1} ) = ", _
                            possibilities, iter)
            defaultListener.Write(binomial)
            defaultListener.WriteLine(result.ToString)
            Console.WriteLine("{0} {1}", binomial, result)
        Next
    End Sub

    Function CalcBinomial(ByVal possibilities As Decimal, _
                        ByVal outcomes As Decimal) As Decimal

        ' Calculate a binomial coefficient, and minimize the chance of overflow.
        Dim result As Decimal = 1
        Dim iter As Decimal
        For iter = 1 To possibilities - outcomes
            result *= outcomes + iter
            result /= iter
        Next
        Return result
    End Function
End Module

Hinweise

Eine Instanz dieser Klasse wird automatisch der-Auflistung und Debug.Listeners der Trace.Listeners -Auflistung hinzugefügt.An instance of this class is automatically added to the Debug.Listeners and Trace.Listeners collections. Durch das explizite hinzu DefaultTraceListener fügen einer Sekunde werden doppelte Nachrichten im Debugger-Ausgabefenster und doppelte Meldungs Felder für Bestätigungen ausgelöst.Explicitly adding a second DefaultTraceListener causes duplicate messages in the debugger output window and duplicate message boxes for asserts.

Standardmäßig geben die Write - WriteLine Methode und die-Methode die-Nachricht an die Win32-Funktion OutputDebugString und an die Debugger.Log -Methode aus.By default, the Write and WriteLine methods emit the message to the Win32 OutputDebugString function and to the Debugger.Log method.

Die Fail -Methode zeigt standardmäßig ein Meldungs Feld an, wenn die Anwendung in einem Benutzeroberflächen Modus ausgeführt wird. Außerdem wird die Nachricht WriteLinemithilfe von ausgegeben.The Fail method, by default, displays a message box when the application is running in a user interface mode; it also emits the message using WriteLine.

Hinweis

Die Anzeige des Meldungs Felds für Assert - Fail und-Methodenaufrufe hängt davon ab, DefaultTraceListenerob der vorhanden ist.The display of the message box for Assert and Fail method calls depends on the presence of the DefaultTraceListener. Wenn sich nicht in der Listeners Auflistung befindet,wirddasMeldungsFeldnichtangezeigt.DefaultTraceListenerIf the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. Clear Listeners System.Diagnostics.Trace.Listeners.Clear() < <Kann durch das Clear >-Element, durch das Remove >-Element entfernt werden, oder durch Aufrufen der-Methode für die-Eigenschaft (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear> element, by the <remove> element, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Sie müssen die Ablauf Verfolgung oder das Debuggen für die Verwendung eines AblaufverfolgungsYou must enable tracing or debugging to use a trace listener. Die folgende Syntax ist compilerspezifisch.The following syntax is compiler specific. Wenn Sie andere Compiler als C# oder Visual Basic verwenden, finden Sie in der Dokumentation Ihres Compiler weitere Informationen.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • Um das Debuggen in C#zu /d:DEBUG aktivieren, fügen Sie das-Flag zur Compilerbefehlszeile hinzu #define DEBUG , wenn Sie den Code kompilieren, oder fügen Sie am Anfang der Datei hinzu.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or add #define DEBUG to the top of your file. Fügen Sie in Visual Basic der /d:DEBUG=True Compilerbefehlszeile das-Flag hinzu.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • Um die Ablauf Verfolgung C#in zu aktivieren /d:TRACE , fügen Sie das Flag der Compilerbefehlszeile hinzu, wenn #define TRACE Sie den Code kompilieren, oder fügen Sie am Anfang der Datei hinzu.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. Fügen Sie in Visual Basic der /d:TRACE=True Compilerbefehlszeile das-Flag hinzu.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

Wenn Sie einen Ablaufverfolgungslistener hinzufügen möchten, bearbeiten Sie die Konfigurationsdatei, die dem Namen der Anwendung entspricht.To add a trace listener, edit the configuration file that corresponds to the name of your application. Innerhalb dieser Datei können Sie einen Listener hinzufügen, seinen Typ festlegen und seine Parameter festlegen, einen Listener entfernen oder alle Listener löschen, die zuvor von der Anwendung festgelegt wurden.Within this file, you can add a listener, set its type and set its parameters, remove a listener, or clear all the listeners previously set by the application. Die Konfigurationsdatei sollte in etwa wie im folgenden Beispiel formatiert sein:The configuration file should be formatted similar to the following example:

<configuration>  
<system.diagnostics>  
  <trace autoflush="false" indentsize="4">  
    <listeners>  
      <remove name="Default" />  
      <add name="myListener"  type="System.Diagnostics.TextWriterTraceListener"    initializeData="c:\myListener.log" />  
    </listeners>  
  </trace>  
</system.diagnostics>  
</configuration>  

Konstruktoren

DefaultTraceListener()

Initialisiert eine neue Instanz der DefaultTraceListener-Klasse, wobei ihr Name-Eigenschaftswert "Default" lautet.Initializes a new instance of the DefaultTraceListener class with "Default" as its Name property value.

Eigenschaften

AssertUiEnabled

Ruft einen Wert ab, der angibt, ob die Anwendung im Benutzeroberflächenmodus ausgeführt wird, oder legt diesen fest.Gets or sets a value indicating whether the application is running in user-interface mode.

Attributes

Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind.Gets the custom trace listener attributes defined in the application configuration file.

(Geerbt von TraceListener)
Filter

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest.Gets or sets the trace filter for the trace listener.

(Geerbt von TraceListener)
IndentLevel

Ruft die Einzugsebene ab oder legt diese fest.Gets or sets the indent level.

(Geerbt von TraceListener)
IndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest.Gets or sets the number of spaces in an indent.

(Geerbt von TraceListener)
IsThreadSafe

Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist.Gets a value indicating whether the trace listener is thread safe.

(Geerbt von TraceListener)
LogFileName

Ruft den Namen einer Protokolldatei ab, in die Ablaufverfolgungs- oder Debugmeldungen geschrieben werden, oder legt diesen fest.Gets or sets the name of a log file to write trace or debug messages to.

Name

Ruft einen Namen für diesen TraceListener ab oder legt diesen fest.Gets or sets a name for this TraceListener.

(Geerbt von TraceListener)
NeedIndent

Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest.Gets or sets a value indicating whether to indent the output.

(Geerbt von TraceListener)
TraceOutputOptions

Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest.Gets or sets the trace output options.

(Geerbt von TraceListener)

Methoden

Close()

Schließt beim Überschreiben in einer abgeleiteten Klasse den Ausgabestream, sodass dieser keine Ablaufverfolgungs- oder Debugausgaben mehr empfängt.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

(Geerbt von TraceListener)
CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom TraceListener verwendeten Ressourcen frei.Releases all resources used by the TraceListener.

(Geerbt von TraceListener)
Dispose(Boolean)

Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Geerbt von TraceListener)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Fail(String)

Gibt eine Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.Emits or displays a message and a stack trace for an assertion that always fails.

Fail(String, String)

Gibt eine detaillierte Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.Emits or displays detailed messages and a stack trace for an assertion that always fails.

Flush()

Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer.When overridden in a derived class, flushes the output buffer.

(Geerbt von TraceListener)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetSupportedAttributes()

Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab.Gets the custom attributes supported by the trace listener.

(Geerbt von TraceListener)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a data object and event information to the listener specific output.

(Geerbt von TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, an array of data objects and event information to the listener specific output.

(Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace and event information to the listener specific output.

(Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a message, and event information to the listener specific output.

(Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Schreibt Ablaufverfolgungsinformationen, ein formatiertes Array von Objekten und Ereignisinformationen in die spezifische Ausgabe des Listeners.Writes trace information, a formatted array of objects and event information to the listener specific output.

(Geerbt von TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen an die spezifische Ausgabe des Listeners.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Geerbt von TraceListener)
Write(Object)

Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Geerbt von TraceListener)
Write(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Geerbt von TraceListener)
Write(String)

Schreibt die Ausgabe in die OutputDebugString-Funktion und die Log(Int32, String, String)-Methode.Writes the output to the OutputDebugString function and to the Log(Int32, String, String) method.

Write(String, String)

Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Geerbt von TraceListener)
WriteIndent()

Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf false zurück.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Geerbt von TraceListener)
WriteLine(Object)

Schreibt den Wert der ToString()-Methode des Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Geerbt von TraceListener)
WriteLine(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Geerbt von TraceListener)
WriteLine(String)

Schreibt die Ausgabe in die OutputDebugString-Funktion und die Log(Int32, String, String)-Methode, gefolgt von einem Wagenrücklauf und einem Zeilenvorschub (\r\n).Writes the output to the OutputDebugString function and to the Log(Int32, String, String) method, followed by a carriage return and line feed (\r\n).

WriteLine(String, String)

Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Geerbt von TraceListener)

Gilt für:

Threadsicherheit

Diese Klasse ist Thread sicher.This class is thread safe.

Siehe auch