Freigeben über


EventSchemaTraceListener Konstruktoren

Definition

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.

Gilt für:

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"))

Gilt für:

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.

Gilt für:

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.

Gilt für:

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

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.

Gilt für:

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

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.

Gilt für: