TraceListener-Klasse

Artikel
08/20/2007

Stellt die abstract-Basisklasse für die Listener bereit, die die Ablaufverfolgung und die Debugausgabe überwachen.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public MustInherit Class TraceListener
    Inherits MarshalByRefObject
    Implements IDisposable
'Usage
Dim instance As TraceListener

public abstract class TraceListener : MarshalByRefObject, IDisposable

public ref class TraceListener abstract : public MarshalByRefObject, IDisposable

public abstract class TraceListener extends MarshalByRefObject implements IDisposable

public abstract class TraceListener extends MarshalByRefObject implements IDisposable

Hinweise

Hinweis

Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert Synchronization. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Beispiele für die Implementierung von TraceListener finden Sie unter der DefaultTraceListener-Klasse, der TextWriterTraceListener-Klasse und der EventLogTraceListener-Klasse.

Sie müssen die Ablaufverfolgung oder das Debuggen aktivieren, um einen Ablaufverfolgungslistener zu verwenden. Die folgende Syntax ist compilerspezifisch. Wenn Sie einen anderen Compiler als C# oder Visual Basic verwenden, finden Sie entsprechende Informationen in der Dokumentation zum Compiler.

Wenn Sie das Debuggen in C# aktivieren möchten, fügen Sie in der Compilerbefehlszeile beim Kompilieren des Codes das /d:DEBUG-Flag hinzu, oder fügen Sie #define DEBUG am Anfang der Datei ein. Fügen Sie in Visual Basic in der Compilerbefehlszeile das /d:DEBUG=True-Flag hinzu.
Wenn Sie die Verwendung der Ablaufverfolgung in C# aktivieren möchten, fügen Sie in der Compilerbefehlszeile beim Kompilieren des Codes das /d:TRACE-Flag hinzu, oder fügen Sie #define TRACE am Anfang der Datei ein. Fügen Sie in Visual Basic in der Compilerbefehlszeile das /d:TRACE=True-Flag hinzu.

Um eine Ablaufverfolgungsüberwachung hinzuzufügen, bearbeiten Sie die Konfigurationsdatei, die dem Namen der Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen und dessen Typ und Parameter festlegen, einen Listener entfernen oder alle Listener löschen, die zuvor durch die Anwendung festgelegt wurden. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert werden.

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

Weitere Informationen über das Verwenden von Konfigurationsdateien für die Ablaufverfolgung finden Sie unter <system.diagnostics>-Element.

Hinweise für Erben Vererben Sie diese Klasse, um einen benutzerdefinierten Listener für die Debug-Klasse und die Trace-Klasse zu implementieren. Sie müssen mindestens die Write-Methode und die WriteLine-Methode implementieren. Zusätzlich können Sie die Fail-Methode, die Close-Methode und die Flush-Methode implementieren.

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
    System.Diagnostics.TraceListener
       Microsoft.VisualBasic.Logging.FileLogTraceListener
       System.Diagnostics.DefaultTraceListener
       System.Diagnostics.EventLogTraceListener
       System.Diagnostics.TextWriterTraceListener
       System.Web.WebPageTraceListener

Threadsicherheit

Dieser Typ ist sicher bei Multithreadoperationen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TraceListener-Member
System.Diagnostics-Namespace
DefaultTraceListener-Klasse
ConsoleTraceListener-Klasse
EventLogTraceListener-Klasse
TextWriterTraceListener-Klasse
Debug-Klasse
Trace-Klasse

Weitere Ressourcen

<system.diagnostics>-Element

Freigeben über