XmlWriterTraceListener Konstruktoren

Referenz

Definition

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.TextWriterTraceListener.dll

Assembly:: System.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.

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse.

Überlädt

XmlWriterTraceListener(Stream)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Stream als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
XmlWriterTraceListener(TextWriter)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Writer als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
XmlWriterTraceListener(String)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
XmlWriterTraceListener(Stream, String)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des angegebenen Streams als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
XmlWriterTraceListener(TextWriter, String)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des angegebenen Writer als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
XmlWriterTraceListener(String, String)	Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

XmlWriterTraceListener(Stream)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Stream als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::IO::Stream ^ stream);

public XmlWriterTraceListener (System.IO.Stream stream);

new System.Diagnostics.XmlWriterTraceListener : System.IO.Stream -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (stream As Stream)

Parameter

stream: Stream

Ein Stream, der den Stream darstellt, in den der Ablaufverfolgungslistener schreibt.

Ausnahmen

ArgumentNullException

stream ist null.

Hinweise

Die Name Eigenschaft wird in eine leere Zeichenfolge ("") initialisiert.

Gilt für:

XmlWriterTraceListener(TextWriter)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Writer als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::IO::TextWriter ^ writer);

public XmlWriterTraceListener (System.IO.TextWriter writer);

new System.Diagnostics.XmlWriterTraceListener : System.IO.TextWriter -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (writer As TextWriter)

Parameter

writer: TextWriter

Ein TextWriter, der die Ausgabe vom Ablaufverfolgungslistener empfängt.

Ausnahmen

ArgumentNullException

writer ist null.

Hinweise

Die Name Eigenschaft wird in eine leere Zeichenfolge ("") initialisiert.

Gilt für:

XmlWriterTraceListener(String)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::String ^ filename);

public XmlWriterTraceListener (string? filename);

public XmlWriterTraceListener (string filename);

new System.Diagnostics.XmlWriterTraceListener : string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (filename As String)

Parameter

filename: String

Der Name der Datei, in die geschrieben werden soll.

Ausnahmen

ArgumentNullException

filename ist null.

Hinweise

Dieser Konstruktor initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei im angegebenen Pfad mithilfe UTF8 der Codierung. Wenn die Datei vorhanden ist, wird sie angefügt. Wenn die Datei nicht vorhanden ist, wird eine neue Datei erstellt.

Hinweis

Um die Wahrscheinlichkeit einer Ausnahme zu verringern, wird jedes Zeichen, das die Ausgabe möglicherweise ungültig macht, durch ein "?"-Zeichen ersetzt.

Die Name Eigenschaft wird in eine leere Zeichenfolge ("") initialisiert.

Gilt für:

XmlWriterTraceListener(Stream, String)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des angegebenen Streams als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::IO::Stream ^ stream, System::String ^ name);

public XmlWriterTraceListener (System.IO.Stream stream, string? name);

public XmlWriterTraceListener (System.IO.Stream stream, string name);

new System.Diagnostics.XmlWriterTraceListener : System.IO.Stream * string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (stream As Stream, name As String)

Parameter

stream: Stream

Ein Stream, der den Stream darstellt, in den der Ablaufverfolgungslistener schreibt.

name: String

Der Name der neuen Instanz.

Ausnahmen

ArgumentNullException

stream ist null.

Hinweise

Dieser Konstruktor initialisiert die Name Eigenschaft auf den name Parameterwert oder eine leere Zeichenfolge ("") wenn der name Parameter lautet null. Der Name kann als Index in der Trace.Listeners Auflistung verwendet werden, um die Eigenschaften für den Listener programmgesteuert zu ändern. Der folgende Code legt beispielsweise die TraceOutputOptions Eigenschaft für eine Instanz fest, deren Name XmlWriterTraceListener Eigenschaft "xmlListener" ist.

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =   
    TraceOptions.Timestamp

Gilt für:

XmlWriterTraceListener(TextWriter, String)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung des angegebenen Writer als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::IO::TextWriter ^ writer, System::String ^ name);

public XmlWriterTraceListener (System.IO.TextWriter writer, string? name);

public XmlWriterTraceListener (System.IO.TextWriter writer, string name);

new System.Diagnostics.XmlWriterTraceListener : System.IO.TextWriter * string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (writer As TextWriter, name As String)

Parameter

writer: TextWriter

Ein TextWriter, der die Ausgabe vom Ablaufverfolgungslistener empfängt.

name: String

Der Name der neuen Instanz.

Ausnahmen

ArgumentNullException

writer ist null.

Hinweise

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =   
    TraceOptions.Timestamp.

Gilt für:

XmlWriterTraceListener(String, String)

Initialisiert eine neue Instanz der XmlWriterTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 XmlWriterTraceListener(System::String ^ filename, System::String ^ name);

public XmlWriterTraceListener (string? filename, string? name);

public XmlWriterTraceListener (string filename, string name);

new System.Diagnostics.XmlWriterTraceListener : string * string -> System.Diagnostics.XmlWriterTraceListener

Public Sub New (filename As String, name As String)

Parameter

filename: String

Der Name der Datei, in die geschrieben werden soll.

name: String

Der Name der neuen Instanz.

Ausnahmen

ArgumentNullException

stream ist null.

Hinweise

Hinweis

Um die Wahrscheinlichkeit einer Ausnahme zu verringern, wird jedes Zeichen, das die Ausgabe möglicherweise ungültig macht, durch ein "?"-Zeichen ersetzt.

Die Name Eigenschaft wird auf den name Parameterwert oder auf eine leere Zeichenfolge ("") festgelegt, wenn der name Parameter ist null. Der Name kann als Index in der Trace.Listeners Auflistung verwendet werden, um die Eigenschaften für den Listener programmgesteuert zu ändern. Der folgende Code legt beispielsweise die TraceOutputOptions Eigenschaft für eine Instanz fest, deren Name XmlWriterTraceListener Eigenschaft "xmlListener" ist.

((XmlWriterTraceListener)Trace.Listeners["xmlListener"]).TraceOutputOptions =  
    TraceOptions.Timestamp.

Gilt für: