EventSchemaTraceListener Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Core.dll

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse.

Überlädt

EventSchemaTraceListener(String)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse, wobei die angegebene Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe verwendet wird.
EventSchemaTraceListener(String, String)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und unter Verwendung der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
EventSchemaTraceListener(String, String, Int32)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie und der maximalen Größe als Empfänger der Debug- oder Ablaufverfolgungsausgabe.
EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)	Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie, der maximalen Größe und der Dateianzahl als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

EventSchemaTraceListener(String)

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse, wobei die angegebene Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe verwendet wird.

public:
 EventSchemaTraceListener(System::String ^ fileName);

public EventSchemaTraceListener (string fileName);

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

Public Sub New (fileName As String)

Parameter

fileName

String

Der Pfad der Protokolldatei.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener.EventSchemaTraceListener(String) Konstruktors veranschaulicht.

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml"));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml"))

Hinweise

Standardmäßig wird eine Datei mit uneingeschränkter Größe protokolliert.

EventSchemaTraceListener(String, String)

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

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name);

public EventSchemaTraceListener (string fileName, string name);

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

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

Parameter

fileName

String

Der Pfad der Protokolldatei.

name

String

Der Name des Listeners.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32) Konstruktors veranschaulicht.

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener"))

EventSchemaTraceListener(String, String, Int32)

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize);

public EventSchemaTraceListener (string fileName, string name, int bufferSize);

new System.Diagnostics.EventSchemaTraceListener : string * string * int -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer)

Parameter

fileName

String

Der Pfad der Protokolldatei.

name

String

Der Name des Listeners.

bufferSize

Int32

Die Größe des Ausgabepuffers in Bytes.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32) Konstruktors veranschaulicht.

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536))

Hinweise

Aus Leistungsgründen bufferSize sollte ein Vielfaches von 1024 Bytes sein.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption)

Parameter

fileName

String

Der Pfad der Protokolldatei.

name

String

Der Name des Listeners.

bufferSize

Int32

Die Größe des Ausgabepuffers in Bytes.

logRetentionOption

TraceLogRetentionOption

Einer der TraceLogRetentionOption-Werte.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption) Konstruktors veranschaulicht.

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles))

Hinweise

Aus Leistungsgründen bufferSize sollte ein Vielfaches von 1024 Bytes sein.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie und der maximalen Größe als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption, long maximumFileSize);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption, long maximumFileSize);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption * int64 -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption, maximumFileSize As Long)

Parameter

fileName

String

Der Pfad der Protokolldatei.

name

String

Der Name des Listeners.

bufferSize

Int32

Die Größe des Ausgabepuffers in Bytes.

logRetentionOption

TraceLogRetentionOption

Einer der TraceLogRetentionOption-Werte.

maximumFileSize

Int64

Die maximale Dateigröße in Bytes.

Ausnahmen

ArgumentOutOfRangeException

maximumFileSize ist eine negative Zahl oder kleiner als bufferSize.

- oder -

bufferSize ist eine negative Zahl.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener.EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64) Konstruktors veranschaulicht.

TraceSource ts = new TraceSource("TestSource");
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000));

Dim ts As New TraceSource("TestSource")
ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000))

Hinweise

Aus Leistungsgründen bufferSize sollte und maximumFileSize ein Vielfaches von 1024 Bytes sein. maximumFileSize ist kein absoluter Wert, es handelt sich um einen Schwellenwert, der bis zur Größe der letzten Nachricht überschritten werden kann.

EventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)

Initialisiert eine neue Instanz der EventSchemaTraceListener-Klasse mit dem angegebenen Namen und der angegebenen Puffergröße unter Verwendung der angegebenen Datei mit der angegebenen Protokollbeibehaltungsrichtlinie, der maximalen Größe und der Dateianzahl als Empfänger der Debug- oder Ablaufverfolgungsausgabe.

public:
 EventSchemaTraceListener(System::String ^ fileName, System::String ^ name, int bufferSize, System::Diagnostics::TraceLogRetentionOption logRetentionOption, long maximumFileSize, int maximumNumberOfFiles);

public EventSchemaTraceListener (string fileName, string name, int bufferSize, System.Diagnostics.TraceLogRetentionOption logRetentionOption, long maximumFileSize, int maximumNumberOfFiles);

new System.Diagnostics.EventSchemaTraceListener : string * string * int * System.Diagnostics.TraceLogRetentionOption * int64 * int -> System.Diagnostics.EventSchemaTraceListener

Public Sub New (fileName As String, name As String, bufferSize As Integer, logRetentionOption As TraceLogRetentionOption, maximumFileSize As Long, maximumNumberOfFiles As Integer)

Parameter

fileName

String

Der Pfad der Protokolldatei.

name

String

Der Name des Listeners.

bufferSize

Int32

Die Größe des Ausgabepuffers in Bytes.

logRetentionOption

TraceLogRetentionOption

Einer der TraceLogRetentionOption-Werte.

maximumFileSize

Int64

Die maximale Dateigröße in Bytes.

maximumNumberOfFiles

Int32

Die maximale Anzahl von Ausgabeprotokolldateien.

Ausnahmen

ArgumentOutOfRangeException

maximumFileSize ist eine negative Zahl oder kleiner als bufferSize.

- oder -

maximumNumberOfFiles ist kleiner als 1, und logRetentionOption ist LimitedSequentialFiles.

- oder -

maximumNumberOfFiles ist kleiner als -2, und logRetentionOption ist LimitedCircularFiles.

- oder -

bufferSize ist eine negative Zahl.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EventSchemaTraceListener Konstruktors veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die EventSchemaTraceListener-Klasse bereitgestellt wird.

//ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2));
ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));

ts.Listeners.Add(New EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2))

Hinweise

Aus Leistungsgründen bufferSize sollte und maximumFileSize ein Vielfaches von 1024 Bytes sein. maximumFileSize ist kein absoluter Wert; Dies ist ein Schwellenwert, der bis zur Größe der letzten Nachricht überschritten werden kann.