EventSource Konstruktoren

  • Referenz

Definition

Namespace:
System.Diagnostics.Tracing
Assembly:
System.Diagnostics.Tracing.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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()

Erstellt eine neue Instanz der EventSource-Klasse.

protected:
 EventSource();
protected EventSource ();
Protected Sub New ()

Gilt für

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.

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)

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 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.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 dem vom EventSourceAttribute Attribut für diesen Typ definierten ETW-Namen entspricht. Andernfalls sind die guiDs, die von der Guid Eigenschaft zurückgegeben werden, und die GetGuid(Type) Methode unterscheidet sich. 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[])

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

ArgumentException

traits ist nicht in Schlüssel-Wert-Paaren 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 nicht in Paaren angegeben, tritt eine Ausnahme auf. Sie können eine Eigenschaft abrufen, indem Sie den Schlüssel an die <xref:System.Diagnostics.Tracing.EventSource.GetTrait%2A>Methode ü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.

Siehe auch

  • <xref:System.Diagnostics.Tracing.EventSource.GetTrait(System.String)>

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.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 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 vom EventSourceAttribute Attribut für diesen Typ definierten ETW-Namen entspricht. Andernfalls sind die guiDs, die von der Guid Eigenschaft zurückgegeben werden, und die GetGuid(Type) Methode unterscheidet sich.

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[])

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

ArgumentNullException

eventSourceName ist null.

ArgumentException

traits ist nicht in Schlüssel-Wert-Paaren 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 nicht in Paaren angegeben, tritt eine Ausnahme auf. Sie können eine Eigenschaft abrufen, indem Sie den Schlüssel an die <xref:System.Diagnostics.Tracing.EventSource.GetTrait%2A>Methode ü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 vom EventSourceAttribute Attribut für diesen Typ definierten ETW-Namen entspricht. Andernfalls sind die guiDs, die von der Guid Eigenschaft zurückgegeben werden, und die GetGuid(Type) Methode unterscheidet sich.

In solchen Fällen ist die GUID, die verwendet wird, um diese EventSource mit ETW zu registrieren, die von Guid.

Siehe auch

  • <xref:System.Diagnostics.Tracing.EventSource.GetTrait(System.String)>

Gilt für