Freigeben über


EventSource Konstruktoren

Definition

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.EventSource
Protected 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.EventSource
Protected 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.EventSource
Public 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.EventSource
Protected 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.EventSource
Public 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.EventSource
Public 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.

Weitere Informationen

Gilt für: