EventSource Konstruktory

Definicja

Przestrzeń nazw:

System.Diagnostics.Tracing

Zestaw:

System.Diagnostics.Tracing.dll

Tworzy nowe wystąpienie klasy EventSource.

Przeciążenia

EventSource()	Tworzy nowe wystąpienie klasy EventSource.
EventSource(Boolean)	Tworzy nowe wystąpienie EventSource klasy i określa, czy zgłaszać wyjątek w przypadku wystąpienia błędu w bazowym kodzie systemu Windows.
EventSource(EventSourceSettings)	Tworzy nowe wystąpienie EventSource klasy z określonymi ustawieniami konfiguracji.
EventSource(String)	Tworzy nowe wystąpienie EventSource klasy o określonej nazwie.
EventSource(EventSourceSettings, String[])	Inicjuje nowe wystąpienie obiektu EventSource , które ma być używane z zdarzeniami niezwiązanymi z kontraktem, które zawiera określone ustawienia i cechy.
EventSource(String, EventSourceSettings)	Tworzy nowe wystąpienie EventSource klasy o określonej nazwie i ustawieniach.
EventSource(String, EventSourceSettings, String[])	Tworzy nowe wystąpienie EventSource klasy z określonymi ustawieniami konfiguracji.

EventSource()

Źródło:

EventSource.cs

Tworzy nowe wystąpienie klasy EventSource.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Źródło:

EventSource.cs

Tworzy nowe wystąpienie EventSource klasy i określa, czy zgłaszać wyjątek w przypadku wystąpienia błędu w bazowym kodzie systemu Windows.

protected:
 EventSource(bool throwOnEventWriteErrors);

protected EventSource (bool throwOnEventWriteErrors);

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

Protected Sub New (throwOnEventWriteErrors As Boolean)

Parametry

throwOnEventWriteErrors

Boolean

true zgłaszać wyjątek w przypadku wystąpienia błędu w bazowym kodzie systemu Windows; w przeciwnym razie , false.

EventSource(EventSourceSettings)

Źródło:

EventSource.cs

Tworzy nowe wystąpienie EventSource klasy z określonymi ustawieniami konfiguracji.

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)

Parametry

settings

EventSourceSettings

Bitowa kombinacja wartości wyliczenia, które określają ustawienia konfiguracji, które mają być stosowane do źródła zdarzeń.

Uwagi

Określenie settings , kiedy EventSource jest skonstruowana, umożliwia określenie, czy zdarzenie jest zapisywane w formacie manifestu, czy samoopisującym. Ponadto można określić, że wyjątek powinien zostać zgłoszony w przypadku wystąpienia błędu podczas procesu zapisywania zdarzeń.

EventSource(String)

Źródło:

TraceLoggingEventSource.cs

Tworzy nowe wystąpienie EventSource klasy o określonej nazwie.

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)

Parametry

eventSourceName

String

Nazwa, która ma być stosowana do źródła zdarzeń. Nie może być .null

Wyjątki

ArgumentNullException

eventSourceName to null.

Uwagi

W przypadku korzystania z tego konstruktora upewnij się, że eventSourceName argument jest zgodny z nazwą ETW zdefiniowaną EventSourceAttribute przez atrybut tego typu. W przeciwnym razie identyfikatory GUID zwrócone przez Guid właściwość i GetGuid(Type) metoda będą inne. Jeśli nazwy źródeł zdarzeń różnią się, Guid właściwość zwraca identyfikator GUID użyty do zarejestrowania tego źródła zdarzeń za pomocą funkcji ETW.

EventSource(EventSourceSettings, String[])

Źródło:

EventSource.cs

Inicjuje nowe wystąpienie obiektu EventSource , które ma być używane z zdarzeniami niezwiązanymi z kontraktem, które zawiera określone ustawienia i cechy.

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

Parametry

settings

EventSourceSettings

Bitowa kombinacja wartości wyliczenia, które określają ustawienia konfiguracji, które mają być stosowane do źródła zdarzeń.

traits

String[]

Pary klucz-wartość, które określają cechy źródła zdarzeń.

Wyjątki

ArgumentException

traits nie jest określony w parach klucz-wartość.

Uwagi

Cechy zapewniają dodatkowe informacje o zdarzeniu i są interpretowane przez odbiornik zdarzeń. Cechy są określane jako pary klucz-wartość, a jeśli nie określono ich w parach, wystąpi wyjątek. Cechę można pobrać, przekazując klucz do GetTraitmetody , .

Określenie settings , kiedy EventSource jest skonstruowana, umożliwia określenie, czy zdarzenie jest zapisywane w formacie manifestu, czy samoopisującym. Ponadto można określić, że wyjątek powinien zostać zgłoszony w przypadku wystąpienia błędu podczas procesu zapisywania zdarzeń.

Zobacz też

• GetTrait(String)

EventSource(String, EventSourceSettings)

Źródło:

TraceLoggingEventSource.cs

Tworzy nowe wystąpienie EventSource klasy o określonej nazwie i ustawieniach.

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)

Parametry

eventSourceName

String

Nazwa, która ma być stosowana do źródła zdarzeń. Nie może być .null

config

EventSourceSettings

Bitowa kombinacja wartości wyliczenia, które określają ustawienia konfiguracji, które mają być stosowane do źródła zdarzeń.

Wyjątki

ArgumentNullException

eventSourceName to null.

Uwagi

Określenie settings , kiedy EventSource jest skonstruowana, umożliwia określenie, czy zdarzenie jest zapisywane w formacie manifestu, czy samoopisującym. Ponadto można określić, że wyjątek powinien zostać zgłoszony w przypadku wystąpienia błędu podczas procesu zapisywania zdarzeń.

W przypadku korzystania z tego konstruktora upewnij się, że eventSourceName argument jest zgodny z nazwą ETW zdefiniowaną EventSourceAttribute przez atrybut tego typu. W przeciwnym razie identyfikatory GUID zwrócone przez Guid właściwość i GetGuid(Type) metoda będą inne.

W takich przypadkach Guid właściwość zwraca identyfikator GUID użyty do zarejestrowania tego źródła zdarzeń za pomocą funkcji ETW.

EventSource(String, EventSourceSettings, String[])

Źródło:

TraceLoggingEventSource.cs

Tworzy nowe wystąpienie EventSource klasy z określonymi ustawieniami konfiguracji.

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

Parametry

eventSourceName

String

Nazwa, która ma być stosowana do źródła zdarzeń. Nie może być .null

config

EventSourceSettings

Bitowa kombinacja wartości wyliczenia, które określają ustawienia konfiguracji, które mają być stosowane do źródła zdarzeń.

traits

String[]

Pary klucz-wartość, które określają cechy źródła zdarzeń.

Wyjątki

ArgumentNullException

eventSourceName to null.

ArgumentException

traits nie jest określony w parach klucz-wartość.

Uwagi

Cechy zapewniają dodatkowe informacje o zdarzeniu i są interpretowane przez odbiornik zdarzeń. Cechy są określane jako pary klucz-wartość, a jeśli nie określono ich w parach, wystąpi wyjątek. Cechę można pobrać, przekazując klucz do GetTraitmetody , .

Określenie config , kiedy EventSource jest skonstruowana, umożliwia określenie, czy zdarzenie jest zapisywane w formacie manifestu, czy samoopisującym. Ponadto można określić, że wyjątek powinien zostać zgłoszony w przypadku wystąpienia błędu podczas procesu zapisywania zdarzeń.

W przypadku korzystania z tego konstruktora upewnij się, że eventSourceName argument jest zgodny z nazwą ETW zdefiniowaną EventSourceAttribute przez atrybut tego typu. W przeciwnym razie identyfikatory GUID zwrócone przez Guid właściwość i GetGuid(Type) metoda będą inne.

W takich przypadkach identyfikator GUID używany do rejestrowania tego źródła zdarzeń za pomocą funkcji ETW jest zwracany przez Guid.

Zobacz też

• GetTrait(String)