EventSource 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.
Erstellt eine neue Instanz der EventSource-Klasse.
Überlädt
| EventSource() |
Erstellt eine neue Instanz der EventSource-Klasse. |
| EventSource(Boolean) |
Erstellt eine neue Instanz der EventSource-Klasse und gibt an, ob eine Ausnahme ausgelöst werden soll, wenn ein Fehler im zugrunde liegenden Windows-Code auftritt. |
| EventSource(EventSourceSettings) |
Erstellt eine neue Instanz der EventSource-Klasse mit den angegebenen Konfigurationseinstellungen. |
| EventSource(String) |
Erstellt eine neue Instanz der EventSource-Klasse mit dem angegebenen Namen. |
| EventSource(EventSourceSettings, String[]) |
Initialisiert eine neue mit nicht im Vertrag enthaltenen Ereignissen zu verwendende Instanz von EventSource, die die angegebenen Einstellungen und Merkmale enthält. |
| EventSource(String, EventSourceSettings) |
Erstellt eine neue Instanz der EventSource-Klasse mit dem angegebenen Namen und den angegebenen Einstellungen. |
| EventSource(String, EventSourceSettings, String[]) |
Erstellt eine neue Instanz der EventSource-Klasse mit den angegebenen Konfigurationseinstellungen. |
EventSource()
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse.
protected:
EventSource();protected EventSource ();Protected Sub New ()Gilt für:
EventSource(Boolean)
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse und gibt an, ob eine Ausnahme ausgelöst werden soll, wenn ein Fehler im zugrunde liegenden Windows-Code auftritt.
protected:
EventSource(bool throwOnEventWriteErrors);protected EventSource (bool throwOnEventWriteErrors);new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSourceProtected Sub New (throwOnEventWriteErrors As Boolean)Parameter
- throwOnEventWriteErrors
- Boolean
true, um eine Ausnahme auszulösen, wenn ein Fehler im zugrunde liegenden Windows-Code auftritt; andernfalls false.
Gilt für:
EventSource(EventSourceSettings)
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse mit den angegebenen Konfigurationseinstellungen.
protected:
EventSource(System::Diagnostics::Tracing::EventSourceSettings settings);protected EventSource (System.Diagnostics.Tracing.EventSourceSettings settings);new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSourceProtected Sub New (settings As EventSourceSettings)Parameter
- settings
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen für die Ereignisquelle angeben.
Hinweise
Wenn Sie angeben settings , wann erstellt EventSource wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder in einem selbstbeschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibprozesses ein Fehler auftritt.
Gilt für:
EventSource(String)
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse mit dem angegebenen Namen.
public:
EventSource(System::String ^ eventSourceName);public EventSource (string eventSourceName);new System.Diagnostics.Tracing.EventSource : string -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String)Parameter
- eventSourceName
- String
Der Name für die Ereignisquelle. Dieser Wert darf nicht null sein.
Ausnahmen
eventSourceName ist null.
Hinweise
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument mit dem ETW-Namen übereinstimmt, der durch das EventSourceAttribute Attribut für diesen Typ definiert wird. Andernfalls unterscheiden sich die GUIDs, die von der Guid -Eigenschaft und der GetGuid(Type) -Methode zurückgegeben werden. Wenn sich die Namen der Ereignisquelle unterscheiden, gibt die Guid Eigenschaft die GUID zurück, die zum Registrieren dieser EventSource bei ETW verwendet wird.
Gilt für:
EventSource(EventSourceSettings, String[])
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
- Quelle:
- EventSource.cs
Initialisiert eine neue mit nicht im Vertrag enthaltenen Ereignissen zu verwendende Instanz von EventSource, die die angegebenen Einstellungen und Merkmale enthält.
protected:
EventSource(System::Diagnostics::Tracing::EventSourceSettings settings, ... cli::array <System::String ^> ^ traits);protected EventSource (System.Diagnostics.Tracing.EventSourceSettings settings, params string[] traits);protected EventSource (System.Diagnostics.Tracing.EventSourceSettings settings, params string[]? traits);new System.Diagnostics.Tracing.EventSource : System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSourceProtected Sub New (settings As EventSourceSettings, ParamArray traits As String())Parameter
- settings
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen für die Ereignisquelle angeben.
- traits
- String[]
Die Schlüsselwertpaare, die Merkmale für die Ereignisquelle angeben.
Ausnahmen
traits ist nicht in Schlüssel-Wert-Paaren angegeben.
Hinweise
Merkmale stellen zusätzliche Informationen für ein Ereignis bereit und werden von einem Ereignislistener interpretiert. Merkmale werden als Schlüssel-Wert-Paare angegeben, und wenn sie nicht in Paaren angegeben werden, tritt eine Ausnahme auf. Sie können ein Merkmal abrufen, indem Sie den Schlüssel an die GetTrait- Methode übergeben.
Wenn Sie angeben settings , wann erstellt EventSource wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder in einem selbstbeschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibprozesses ein Fehler auftritt.
Weitere Informationen
Gilt für:
EventSource(String, EventSourceSettings)
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse mit dem angegebenen Namen und den angegebenen Einstellungen.
public:
EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config);public EventSource (string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config);new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, config As EventSourceSettings)Parameter
- eventSourceName
- String
Der Name für die Ereignisquelle. Dieser Wert darf nicht null sein.
- config
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen für die Ereignisquelle angeben.
Ausnahmen
eventSourceName ist null.
Hinweise
Wenn Sie angeben settings , wann erstellt EventSource wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder in einem selbstbeschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibprozesses ein Fehler auftritt.
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument mit dem ETW-Namen übereinstimmt, der durch das EventSourceAttribute Attribut für diesen Typ definiert wird. Andernfalls unterscheiden sich die GUIDs, die von der Guid -Eigenschaft und der GetGuid(Type) -Methode zurückgegeben werden.
In solchen Fällen gibt die Guid -Eigenschaft die GUID zurück, die zum Registrieren dieser EventSource bei ETW verwendet wird.
Gilt für:
EventSource(String, EventSourceSettings, String[])
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
- Quelle:
- TraceLoggingEventSource.cs
Erstellt eine neue Instanz der EventSource-Klasse mit den angegebenen Konfigurationseinstellungen.
public:
EventSource(System::String ^ eventSourceName, System::Diagnostics::Tracing::EventSourceSettings config, ... cli::array <System::String ^> ^ traits);public EventSource (string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config, params string[] traits);public EventSource (string eventSourceName, System.Diagnostics.Tracing.EventSourceSettings config, params string[]? traits);new System.Diagnostics.Tracing.EventSource : string * System.Diagnostics.Tracing.EventSourceSettings * string[] -> System.Diagnostics.Tracing.EventSourcePublic Sub New (eventSourceName As String, config As EventSourceSettings, ParamArray traits As String())Parameter
- eventSourceName
- String
Der Name für die Ereignisquelle. Dieser Wert darf nicht null sein.
- config
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen für die Ereignisquelle angeben.
- traits
- String[]
Die Schlüsselwertpaare, die Merkmale für die Ereignisquelle angeben.
Ausnahmen
eventSourceName ist null.
traits ist nicht in Schlüssel-Wert-Paaren angegeben.
Hinweise
Merkmale stellen zusätzliche Informationen für ein Ereignis bereit und werden von einem Ereignislistener interpretiert. Merkmale werden als Schlüssel-Wert-Paare angegeben, und wenn sie nicht in Paaren angegeben werden, tritt eine Ausnahme auf. Sie können ein Merkmal abrufen, indem Sie den Schlüssel an die GetTrait- Methode übergeben.
Wenn Sie angeben config , wann erstellt EventSource wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder in einem selbstbeschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibprozesses ein Fehler auftritt.
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument mit dem ETW-Namen übereinstimmt, der durch das EventSourceAttribute Attribut für diesen Typ definiert wird. Andernfalls unterscheiden sich die GUIDs, die von der Guid -Eigenschaft und der GetGuid(Type) -Methode zurückgegeben werden.
In solchen Fällen ist die GUID, die zum Registrieren dieser EventSource bei ETW verwendet wird, die von Guidzurückgegeben wird.
