TraceSource Konstruktoren
Definition
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 TraceSource-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| TraceSource(String) |
Initialisiert eine neue Instanz der TraceSource Klasse, wobei der angegebene Name für die Quelle verwendet wird. |
| TraceSource(String, SourceLevels) |
Initialisiert eine neue Instanz der TraceSource Klasse, wobei der angegebene Name für die Quelle und die Standardquellebene verwendet wird, auf der die Ablaufverfolgung erfolgen soll. |
TraceSource(String)
Initialisiert eine neue Instanz der TraceSource Klasse, wobei der angegebene Name für die Quelle verwendet wird.
public:
TraceSource(System::String ^ name);public TraceSource(string name);new System.Diagnostics.TraceSource : string -> System.Diagnostics.TraceSourcePublic Sub New (name As String)Parameter
- name
- String
Der Name der Quelle (in der Regel der Name der Anwendung).
Ausnahmen
name ist null.
name ist eine leere Zeichenfolge ("").
Beispiele
Das folgende Codebeispiel zeigt die Verwendung des TraceSource Konstruktors zum Erstellen eines neuen TraceSource Objekts. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource Klasse bereitgestellt wird.
// Initialize the trace source.
static TraceSource ts = new TraceSource("TraceTest");
' Initialize the trace source.
Private Shared ts As New TraceSource("TraceTest")
Hinweise
Der Quellname wird verwendet, um Ablaufverfolgungen zu identifizieren. Es wird von einem SourceFilter verwendet, um zu bestimmen, ob ein Ablaufverfolgungslistener die Ablaufverfolgung erzeugen soll. Die empfohlene Vorgehensweise besteht darin, den Namen der Anwendung für den Quellnamen zu verwenden.
Note
Es ist nicht erforderlich, für jede Ablaufverfolgungsanforderung eine neue TraceSource Instanz zu erstellen. Erstellen Sie eine TraceSource Instanz, und verwenden Sie sie für alle Ablaufverfolgungsanforderungen für die Anwendung.
Gilt für:
TraceSource(String, SourceLevels)
Initialisiert eine neue Instanz der TraceSource Klasse, wobei der angegebene Name für die Quelle und die Standardquellebene verwendet wird, auf der die Ablaufverfolgung erfolgen soll.
public:
TraceSource(System::String ^ name, System::Diagnostics::SourceLevels defaultLevel);public TraceSource(string name, System.Diagnostics.SourceLevels defaultLevel);new System.Diagnostics.TraceSource : string * System.Diagnostics.SourceLevels -> System.Diagnostics.TraceSourcePublic Sub New (name As String, defaultLevel As SourceLevels)Parameter
- name
- String
Der Name der Quelle, in der Regel der Name der Anwendung.
- defaultLevel
- SourceLevels
Eine bitweise Kombination der Enumerationswerte, die die Standardquellebene angibt, auf der nachverfolgt werden soll.
Ausnahmen
name ist null.
name ist eine leere Zeichenfolge ("").
Hinweise
Der Quellname wird verwendet, um Ablaufverfolgungen zu identifizieren. Es kann von einer SourceSwitch verwendet werden, um zu bestimmen, ob die Ablaufverfolgung erfolgt, und von einer SourceFilter , um zu bestimmen, ob die Ablaufverfolgung erzeugt werden soll. Die Standardquellebene wird von einer EventTypeFilter verwendet, um zu bestimmen, ob die Ablaufverfolgung basierend auf der Quellebene der zu verfolgenden Nachricht erfolgt.
Note
Es ist nicht erforderlich, für jede Ablaufverfolgungsanforderung eine neue TraceSource Instanz zu erstellen. Erstellen Sie eine TraceSource Instanz, und verwenden Sie sie für alle Ablaufverfolgungsanforderungen für die Anwendung.