DefaultTraceListener Klasse

Referenz

Definition

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.TraceSource.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die Standardmethoden für die Ausgabe und das Standardverhalten für die Ablaufverfolgung bereit.

public ref class DefaultTraceListener : System::Diagnostics::TraceListener

public class DefaultTraceListener : System.Diagnostics.TraceListener

[System.Runtime.InteropServices.ComVisible(false)]
public class DefaultTraceListener : System.Diagnostics.TraceListener

type DefaultTraceListener = class
    inherit TraceListener

[<System.Runtime.InteropServices.ComVisible(false)>]
type DefaultTraceListener = class
    inherit TraceListener

Public Class DefaultTraceListener
Inherits TraceListener

Vererbung: Object

MarshalByRefObject

TraceListener
DefaultTraceListener

Vererbung: Object

TraceListener
DefaultTraceListener

Attribute: ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel werden binomiale Koeffizienten berechnet, die in Wahrscheinlichkeit und Statistiken verwendet werden. In diesem Beispiel wird eine DefaultTraceListener Ablaufverfolgung von Ergebnissen und Protokollfehlern verwendet. Es erstellt eine neue DefaultTraceListener, fügt es der Trace.Listeners Auflistung hinzu und legt die LogFileName Eigenschaft auf die in den Befehlszeilenargumenten angegebene Protokolldatei fest.

Wenn beim Verarbeiten des Eingabeparameters ein Fehler erkannt wird, oder wenn die Funktion eine Ausnahme ausgelöst hat, protokolliert die CalcBinomial Fail Methode und zeigt eine Fehlermeldung an. Wenn die AssertUiEnabled Eigenschaft lautet false, wird die Fehlermeldung auch in die Konsole geschrieben. Wenn das Ergebnis erfolgreich berechnet wird, schreiben die Write(String) Und WriteLine(String) Methoden die Ergebnisse in die Protokolldatei.

Die FailMethoden und WriteLine Methoden führen dazu, Writedass Ablaufverfolgungsinformationen nur auf den Geschriebenen DefaultTraceListenergeschrieben werden. Um Ablaufverfolgungsinformationen in alle Listener in der Trace.Listeners Auflistung zu schreiben, verwenden Sie die Fail WriteMethoden und WriteLine Methoden der Trace Klasse.

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 zu den Debug.Listeners Sammlungen Trace.Listeners hinzugefügt. Das Hinzufügen einer Zweiten DefaultTraceListener verursacht doppelte Nachrichten im Debuggerausgabefenster und duplizierte Nachrichtenfelder für die Durchsetzung.

Standardmäßig geben die Und WriteLine Methoden die Write Nachricht an die Win32 OutputDebugString-Funktion und die Debugger.Log Methode aus.

Die Fail Methode zeigt standardmäßig ein Meldungsfeld an, wenn die Anwendung im Benutzeroberflächenmodus ausgeführt wird. Außerdem wird die Nachricht mithilfe WriteLineder Nachricht ausgegeben.

Hinweis

Die Anzeige des Meldungsfelds für Assert und Fail Methodenaufrufe hängt von der Anwesenheit des DefaultTraceListenerNachrichtenfelds ab. Wenn sich die DefaultTraceListener Listeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch Aufrufen der Clear Methode auf der Listeners Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()) entfernt werden. Für .NET Framework Apps können Sie auch das Element und das <remove> Element in der <clear> Konfigurationsdatei Ihrer App verwenden.

Sie müssen die Ablaufverfolgung oder das Debuggen aktivieren, um einen Ablaufverfolgungslistener zu verwenden. Die folgende Syntax ist compilerspezifisch. Wenn Sie Compiler außer C# oder Visual Basic verwenden, lesen Sie die Dokumentation für Ihren Compiler.

Um das Debuggen in C# zu aktivieren, fügen Sie das /d:DEBUG Flag zur Compilerbefehlszeile hinzu, wenn Sie Ihren Code kompilieren oder oben in der Datei hinzufügen #define DEBUG . Fügen Sie in Visual Basic das /d:DEBUG=True Flag zur Compilerbefehlszeile hinzu.
Um die Ablaufverfolgung in C# zu aktivieren, fügen Sie die /d:TRACE Flag zur Compilerbefehlszeile hinzu, wenn Sie Ihren Code kompilieren oder oben in der Datei hinzufügen #define TRACE . Fügen Sie in Visual Basic das /d:TRACE=True Flag zur Compilerbefehlszeile hinzu.

Für .NET Framework-Apps können Sie einen Ablaufverfolgungslistener hinzufügen, indem Sie die Konfigurationsdatei bearbeiten, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen, seinen Typ festlegen und seine Parameter festlegen, einen Listener entfernen oder alle zuvor von der Anwendung festgelegten Listener löschen. Die Konfigurationsdatei sollte ähnlich wie im folgenden Beispiel formatiert werden:

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

Eigenschaften

AssertUiEnabled	Ruft einen Wert ab, der angibt, ob die Anwendung im Benutzeroberflächenmodus ausgeführt wird, oder legt diesen fest.
Attributes	Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener)
Filter	Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest. (Geerbt von TraceListener)
IndentLevel	Ruft die Einzugsebene ab oder legt diese fest. (Geerbt von TraceListener)
IndentSize	Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. (Geerbt von TraceListener)
IsThreadSafe	Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener)
LogFileName	Ruft den Namen einer Protokolldatei ab, in die Ablaufverfolgungs- oder Debugmeldungen geschrieben werden, oder legt diesen fest.
Name	Ruft einen Namen für diesen TraceListener ab oder legt diesen fest. (Geerbt von TraceListener)
NeedIndent	Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest. (Geerbt von TraceListener)
TraceOutputOptions	Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest. (Geerbt von TraceListener)

Methoden

Close()	Schließt beim Überschreiben in einer abgeleiteten Klasse den Ausgabestream, sodass dieser keine Ablaufverfolgungs- oder Debugausgaben mehr empfängt. (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. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom TraceListener verwendeten Ressourcen frei. (Geerbt von TraceListener)
Dispose(Boolean)	Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von TraceListener)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (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.
Fail(String, String)	Gibt eine detaillierte Meldung und eine Stapelüberwachung für eine Assertion aus, die immer fehlschlägt, oder zeigt diese an.
Flush()	Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer. (Geerbt von TraceListener)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSupportedAttributes()	Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab. (Geerbt von TraceListener)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Schreibt Ablaufverfolgungsinformationen, eine Meldung und Ereignisinformationen in die spezifische Ausgabe des Listeners. (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. (Geerbt von TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
Write(Object)	Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (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. (Geerbt von TraceListener)
Write(String)	Schreibt die Ausgabe in die `OutputDebugString`-Funktion und die Log(Int32, String, String)-Methode.
Write(String, String)	Schreibt einen Kategorienamen und eine Meldung in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (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. (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. (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. (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).
WriteLine(String, String)	Schreibt einen Kategorienamen und eine Meldung gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)

Gilt für

Threadsicherheit

Diese Klasse ist threadsicher.