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
| Name | Beschreibung |
|---|---|
| EventSource() |
Erstellt eine neue Instanz der EventSource Klasse. |
| EventSource(Boolean) |
Erstellt eine neue Instanz der klasse EventSource 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 Instanz der EventSource zu verwendenden Instanz mit Nicht-Vertragsereignissen, die die angegebenen Einstellungen und Merkmale enthalten. |
| 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()
Erstellt eine neue Instanz der EventSource Klasse.
protected:
EventSource();protected EventSource();Protected Sub New ()Gilt für:
EventSource(Boolean)
Erstellt eine neue Instanz der klasse EventSource 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 eine Ausnahme auslösen, wenn ein Fehler im zugrunde liegenden Windows Code auftritt; andernfalls false.
Gilt für:
EventSource(EventSourceSettings)
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 angeben, die auf die Ereignisquelle angewendet werden sollen.
Hinweise
Wenn settings sie EventSource erstellt wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder selbst beschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibvorgangs ein Fehler auftritt.
Gilt für:
EventSource(String)
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, der auf die Ereignisquelle angewendet werden soll. Dieser Wert darf nicht null sein.
Ausnahmen
eventSourceName ist null.
Hinweise
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument dem durch das Attribut für diesen EventSourceAttribute Typ definierten ETW-Namen entspricht. Andernfalls unterscheiden sich die von der Guid Eigenschaft zurückgegebenen GUIDs und die GetGuid(Type) Methode. Wenn sich die Ereignisquellnamen unterscheiden, gibt die Eigenschaft die Guid GUID zurück, die zum Registrieren dieser EventSource bei ETW verwendet wird.
Gilt für:
EventSource(EventSourceSettings, String[])
Initialisiert eine neue Instanz der EventSource zu verwendenden Instanz mit Nicht-Vertragsereignissen, die die angegebenen Einstellungen und Merkmale enthalten.
protected:
EventSource(System::Diagnostics::Tracing::EventSourceSettings settings, ... cli::array <System::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 angeben, die auf die Ereignisquelle angewendet werden sollen.
- traits
- String[]
Die Schlüsselwertpaare, die Eigenschaften für die Ereignisquelle angeben.
Ausnahmen
traits ist in Schlüssel-Wert-Paaren nicht angegeben.
Hinweise
Eigenschaften bieten zusätzliche Informationen für ein Ereignis und werden von einem Ereignislistener interpretiert. Eigenschaften werden als Schlüsselwertpaare angegeben und wenn sie nicht in Paaren angegeben sind, tritt eine Ausnahme auf. Sie können eine Eigenschaft abrufen, indem Sie den Schlüssel an die GetTraitMethode übergeben.
Wenn settings sie EventSource erstellt wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder selbst beschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibvorgangs ein Fehler auftritt.
Weitere Informationen
Gilt für:
EventSource(String, EventSourceSettings)
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, der auf die Ereignisquelle angewendet werden soll. Dieser Wert darf nicht null sein.
- config
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen angeben, die auf die Ereignisquelle angewendet werden sollen.
Ausnahmen
eventSourceName ist null.
Hinweise
Wenn settings sie EventSource erstellt wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder selbst beschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibvorgangs ein Fehler auftritt.
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument dem durch das Attribut für diesen EventSourceAttribute Typ definierten ETW-Namen entspricht. Andernfalls unterscheiden sich die von der Guid Eigenschaft zurückgegebenen GUIDs und die GetGuid(Type) Methode.
In solchen Fällen gibt die Eigenschaft die Guid GUID zurück, die zum Registrieren dieser EventSource bei ETW verwendet wird.
Gilt für:
EventSource(String, EventSourceSettings, String[])
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);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, der auf die Ereignisquelle angewendet werden soll. Dieser Wert darf nicht null sein.
- config
- EventSourceSettings
Eine bitweise Kombination der Enumerationswerte, die die Konfigurationseinstellungen angeben, die auf die Ereignisquelle angewendet werden sollen.
- traits
- String[]
Die Schlüsselwertpaare, die Eigenschaften für die Ereignisquelle angeben.
Ausnahmen
eventSourceName ist null.
traits ist in Schlüssel-Wert-Paaren nicht angegeben.
Hinweise
Eigenschaften bieten zusätzliche Informationen für ein Ereignis und werden von einem Ereignislistener interpretiert. Eigenschaften werden als Schlüsselwertpaare angegeben und wenn sie nicht in Paaren angegeben sind, tritt eine Ausnahme auf. Sie können eine Eigenschaft abrufen, indem Sie den Schlüssel an die GetTraitMethode übergeben.
Wenn config sie EventSource erstellt wird, können Sie angeben, ob das Ereignis in einem manifestbasierten oder selbst beschreibenden Format geschrieben wird. Darüber hinaus können Sie angeben, dass eine Ausnahme ausgelöst werden soll, wenn während des Ereignisschreibvorgangs ein Fehler auftritt.
Stellen Sie bei Verwendung dieses Konstruktors sicher, dass das eventSourceName Argument dem durch das Attribut für diesen EventSourceAttribute Typ definierten ETW-Namen entspricht. Andernfalls unterscheiden sich die von der Guid Eigenschaft zurückgegebenen GUIDs und die GetGuid(Type) Methode.
In solchen Fällen ist die GUID, die zum Registrieren dieser EventSource bei ETW verwendet wird, die von Guid.