TraceListenerCollection-Klasse

Stellt eine threadsichere Liste von TraceListener-Objekten bereit.

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

Syntax

'Declaration
Public Class TraceListenerCollection
    Implements IList, ICollection, IEnumerable
'Usage
Dim instance As TraceListenerCollection

public class TraceListenerCollection : IList, ICollection, IEnumerable

public ref class TraceListenerCollection : IList, ICollection, IEnumerable

public class TraceListenerCollection implements IList, ICollection, 
    IEnumerable

public class TraceListenerCollection implements IList, ICollection, 
    IEnumerable

Hinweise

In der TraceListenerCollection-Liste werden die Ausgabelistener für die Trace.Listeners-Auflistung und die Debug.Listeners-Auflistung angegeben. Sie können keine Instanz dieser Klasse erstellen.

Diese Liste ist threadsicher, die Methoden für den Zugriff auf die Liste und den Enumerator akzeptieren jedoch keine Synchronisierungssperren. Stattdessen wird die Auflistung kopiert, die Kopie bearbeitet und ein Verweis auf die Kopie der Auflistung festgelegt. Methoden wie Add, Remove und Clear ändern die Elemente in der Auflistung.

Die TraceListenerCollection-Klasse stellt die Count-Eigenschaft mit Informationen über die Liste bereit. Außerdem stehen die folgenden Methoden zur Verfügung: Contains, GetEnumerator, IndexOf.

Diese Klasse stellt außerdem folgende Methoden zum Bearbeiten der Liste bereit: Add, Clear, Insert und Remove. Die CopyTo-Methode kopiert einen Teil der Liste in ein Array. Die RemoveAt-Methode löscht den Member der Liste an der angegebenen Indexnummer.

Beispiel

Im folgenden Beispiel wird ein TextWriterTraceListener für die Ausgabe im Konsolenfenster erstellt. Der Code fügt anschließend Trace.Listeners den neuen Listener hinzu.

' Create a ConsoleTraceListener and add it to the trace listeners. 
Dim myWriter As New ConsoleTraceListener()
Trace.Listeners.Add(myWriter)

/* Create a ConsoleTraceListener and add it to the trace listeners. */
ConsoleTraceListener myWriter = new
   ConsoleTraceListener();
Trace.Listeners.Add(myWriter);

/* Create a ConsoletTraceListener and add it to the trace listeners. */
ConsoleTraceListener^ myWriter =
   gcnew ConsoleTraceListener( );
Trace::Listeners->Add( myWriter );

/* Create a ConsoleTraceListener and add it to the trace listeners. 
 */
ConsoleTraceListener myWriter =
    new ConsoleTraceListener();
Trace.get_Listeners().Add(myWriter);

// Create a listener, which outputs to the console screen, and 
// add it to the trace listeners. 
var myWriter : TextWriterTraceListener = new TextWriterTraceListener(System.Console.Out)
Trace.Listeners.Add(myWriter)
Trace.Write("Error output")

Vererbungshierarchie

System.Object
  System.Diagnostics.TraceListenerCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

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