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
| TraceSource(String) |
Initialisiert eine neue Instanz der TraceSource-Klasse, wobei der angegebene Namen der Quelle verwendet wird. |
| TraceSource(String, SourceLevels) |
Initialisiert eine neue Instanz der TraceSource-Klasse, wobei der angegebene Name der Quelle und die Standardebene der Quelle verwendet werden, auf der die Ablaufverfolgung durchgeführt werden soll. |
TraceSource(String)
Initialisiert eine neue Instanz der TraceSource-Klasse, wobei der angegebene Namen der 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 (i. d. R. 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 Methode besteht darin, den Namen der Anwendung für den Quellnamen zu verwenden.
Hinweis
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 der Quelle und die Standardebene der Quelle verwendet werden, auf der die Ablaufverfolgung durchgeführt werden 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, i. d. R. der Name der Anwendung.
- defaultLevel
- SourceLevels
Eine bitweise Kombination der Enumerationswerte, die die Standardebene der Quelle angibt, auf der die Ablaufverfolgung durchgeführt 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 festzustellen, ob die Ablaufverfolgung erfolgt und von einer SourceFilter , um zu bestimmen, ob die Ablaufverfolgung erzeugt werden soll. Die Standardquellenebene wird von einer EventTypeFilter verwendet, um festzustellen, ob die Ablaufverfolgung basierend auf der Quellebene der zu verfolgenden Nachricht erfolgen soll.
Hinweis
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.