EventSource Konstruktoren

Definition

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

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

Erstellt eine neue Instanz der EventSource-Klasse.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

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.

EventSource(EventSourceSettings)

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.

EventSource(String)

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

ArgumentNullException

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.

EventSource(EventSourceSettings, String[])

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);

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

ArgumentException

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

• GetTrait(String)

EventSource(String, EventSourceSettings)

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

ArgumentNullException

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.

EventSource(String, EventSourceSettings, String[])

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);

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

ArgumentNullException

eventSourceName ist null.

ArgumentException

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

• GetTrait(String)