EventSource Oluşturucular

Tanım

Ad Alanı:

System.Diagnostics.Tracing

Bütünleştirilmiş Kod:

System.Diagnostics.Tracing.dll

EventSource sınıfının yeni bir örneğini oluşturur.

Aşırı Yüklemeler

EventSource()	EventSource sınıfının yeni bir örneğini oluşturur.
EventSource(Boolean)	sınıfının yeni bir örneğini EventSource oluşturur ve temel alınan Windows kodunda bir hata oluştuğunda özel durum oluşturup oluşturmayacağını belirtir.
EventSource(EventSourceSettings)	Belirtilen yapılandırma ayarlarıyla sınıfının yeni bir örneğini EventSource oluşturur.
EventSource(String)	Belirtilen ada sahip sınıfın EventSource yeni bir örneğini oluşturur.
EventSource(EventSourceSettings, String[])	Belirtilen ayarları ve özellikleri içeren sözleşme dışı olaylarla kullanılacak yeni bir örneğini EventSource başlatır.
EventSource(String, EventSourceSettings)	Belirtilen ad ve ayarlarla sınıfının yeni bir örneğini EventSource oluşturur.
EventSource(String, EventSourceSettings, String[])	Belirtilen yapılandırma ayarlarıyla sınıfının yeni bir örneğini EventSource oluşturur.

EventSource()

Kaynak:

EventSource.cs

EventSource sınıfının yeni bir örneğini oluşturur.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Kaynak:

EventSource.cs

sınıfının yeni bir örneğini EventSource oluşturur ve temel alınan Windows kodunda bir hata oluştuğunda özel durum oluşturup oluşturmayacağını belirtir.

protected:
 EventSource(bool throwOnEventWriteErrors);

protected EventSource (bool throwOnEventWriteErrors);

new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSource

Protected Sub New (throwOnEventWriteErrors As Boolean)

Parametreler

throwOnEventWriteErrors

Boolean

true temel alınan Windows kodunda bir hata oluştuğunda özel durum oluşturma; aksi takdirde , false.

EventSource(EventSourceSettings)

Kaynak:

EventSource.cs

Belirtilen yapılandırma ayarlarıyla sınıfının yeni bir örneğini EventSource oluşturur.

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)

Parametreler

settings

EventSourceSettings

Olay kaynağına uygulanacak yapılandırma ayarlarını belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

Açıklamalar

settings öğesinin EventSource ne zaman oluşturulacağını belirtmek, olayın bildirim tabanlı mı yoksa kendi kendini açıklayan bir biçimde mi yazılacağını belirtmenize olanak tanır. Buna ek olarak, olay yazma işlemi sırasında bir hata oluştuğunda bir özel durumun tetiklenmesi gerektiğini belirtebilirsiniz.

EventSource(String)

Kaynak:

TraceLoggingEventSource.cs

Belirtilen ada sahip sınıfın EventSource yeni bir örneğini oluşturur.

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)

Parametreler

eventSourceName

String

Olay kaynağına uygulanacak ad. olmamalıdır null.

Özel durumlar

ArgumentNullException

eventSourceName, null değeridir.

Açıklamalar

Bu oluşturucuyu kullanırken bağımsız değişkenin bu türdeki eventSourceName özniteliği tarafından tanımlanan ETW adıyla eşleştiğinden EventSourceAttribute emin olun. Aksi takdirde, özelliği GetGuid(Type) ve yöntemi tarafından Guid döndürülen GUID'ler farklı olur. Olay kaynağı adları farklıysa, Guid özelliği bu EventSource'un ETW'ye kaydedilmesi için kullanılan GUID'yi döndürür.

EventSource(EventSourceSettings, String[])

Kaynak:

EventSource.cs

Belirtilen ayarları ve özellikleri içeren sözleşme dışı olaylarla kullanılacak yeni bir örneğini EventSource başlatır.

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

Parametreler

settings

EventSourceSettings

Olay kaynağına uygulanacak yapılandırma ayarlarını belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

traits

String[]

Olay kaynağı için özellikleri belirten anahtar-değer çiftleri.

Özel durumlar

ArgumentException

traits anahtar-değer çiftlerinde belirtilmez.

Açıklamalar

Özellikler bir olay için ek bilgi sağlar ve olay dinleyicisi tarafından yorumlanır. Nitelikler anahtar-değer çiftleri olarak belirtilir ve çiftler içinde belirtilmezse bir özel durum oluşur. anahtarını yöntemine GetTraitgeçirerek bir özelliği alabilirsiniz.

settings öğesinin EventSource ne zaman oluşturulacağını belirtmek, olayın bildirim tabanlı mı yoksa kendi kendini açıklayan bir biçimde mi yazılacağını belirtmenize olanak tanır. Buna ek olarak, olay yazma işlemi sırasında bir hata oluştuğunda bir özel durumun tetiklenmesi gerektiğini belirtebilirsiniz.

Ayrıca bkz.

• GetTrait(String)

EventSource(String, EventSourceSettings)

Kaynak:

TraceLoggingEventSource.cs

Belirtilen ad ve ayarlarla sınıfının yeni bir örneğini EventSource oluşturur.

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)

Parametreler

eventSourceName

String

Olay kaynağına uygulanacak ad. olmamalıdır null.

config

EventSourceSettings

Olay kaynağına uygulanacak yapılandırma ayarlarını belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

Özel durumlar

ArgumentNullException

eventSourceName, null değeridir.

Açıklamalar

settings öğesinin EventSource ne zaman oluşturulacağını belirtmek, olayın bildirim tabanlı mı yoksa kendi kendini açıklayan bir biçimde mi yazılacağını belirtmenize olanak tanır. Buna ek olarak, olay yazma işlemi sırasında bir hata oluştuğunda bir özel durumun tetiklenmesi gerektiğini belirtebilirsiniz.

Bu oluşturucuyu kullanırken bağımsız değişkenin bu türdeki eventSourceName özniteliği tarafından tanımlanan ETW adıyla eşleştiğinden EventSourceAttribute emin olun. Aksi takdirde, özelliği GetGuid(Type) ve yöntemi tarafından Guid döndürülen GUID'ler farklı olur.

Böyle durumlarda özelliği, Guid bu EventSource'un ETW'ye kaydedilmesi için kullanılan GUID'yi döndürür.

EventSource(String, EventSourceSettings, String[])

Kaynak:

TraceLoggingEventSource.cs

Belirtilen yapılandırma ayarlarıyla sınıfının yeni bir örneğini EventSource oluşturur.

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

Parametreler

eventSourceName

String

Olay kaynağına uygulanacak ad. olmamalıdır null.

config

EventSourceSettings

Olay kaynağına uygulanacak yapılandırma ayarlarını belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

traits

String[]

Olay kaynağı için özellikleri belirten anahtar-değer çiftleri.

Özel durumlar

ArgumentNullException

eventSourceName, null değeridir.

ArgumentException

traits anahtar-değer çiftlerinde belirtilmez.

Açıklamalar

Özellikler bir olay için ek bilgi sağlar ve olay dinleyicisi tarafından yorumlanır. Nitelikler anahtar-değer çiftleri olarak belirtilir ve çiftler içinde belirtilmezse bir özel durum oluşur. anahtarını yöntemine GetTraitgeçirerek bir özelliği alabilirsiniz.

config öğesinin EventSource ne zaman oluşturulacağını belirtmek, olayın bildirim tabanlı mı yoksa kendi kendini açıklayan bir biçimde mi yazılacağını belirtmenize olanak tanır. Buna ek olarak, olay yazma işlemi sırasında bir hata oluştuğunda bir özel durumun tetiklenmesi gerektiğini belirtebilirsiniz.

Bu oluşturucuyu kullanırken bağımsız değişkenin bu türdeki eventSourceName özniteliği tarafından tanımlanan ETW adıyla eşleştiğinden EventSourceAttribute emin olun. Aksi takdirde, özelliği GetGuid(Type) ve yöntemi tarafından Guid döndürülen GUID'ler farklı olur.

Böyle durumlarda, bu EventSource'ı ETW'ye kaydetmek için kullanılan GUID tarafından Guiddöndürülen guid'dir.

Ayrıca bkz.

• GetTrait(String)