EventSource Costruttori

Definizione

Spazio dei nomi:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Crea una nuova istanza della classe EventSource.

Overload

EventSource()	Crea una nuova istanza della classe EventSource.
EventSource(Boolean)	Crea una nuova istanza della classe EventSource e specifica se generare un'eccezione quando si verifica un errore nel codice sottostante di Windows.
EventSource(EventSourceSettings)	Crea una nuova istanza della classe EventSource con le impostazioni di configurazione specificate.
EventSource(String)	Crea una nuova istanza della classe EventSource con il nome specificato.
EventSource(EventSourceSettings, String[])	Inizializza una nuova istanza dell'oggetto EventSource da usare con eventi non di contratto che contengono le impostazioni e i tratti specificati.
EventSource(String, EventSourceSettings)	Crea una nuova istanza della classe EventSource con il nome e le impostazioni specificate.
EventSource(String, EventSourceSettings, String[])	Crea una nuova istanza della classe EventSource con le impostazioni di configurazione specificate.

EventSource()

Origine:

EventSource.cs

Crea una nuova istanza della classe EventSource.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Origine:

EventSource.cs

Crea una nuova istanza della classe EventSource e specifica se generare un'eccezione quando si verifica un errore nel codice sottostante di 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)

Parametri

throwOnEventWriteErrors

Boolean

true per generare un'eccezione quando si verifica un errore nel codice sottostante di Windows; in caso contrario, false.

EventSource(EventSourceSettings)

Origine:

EventSource.cs

Crea una nuova istanza della classe EventSource con le impostazioni di configurazione specificate.

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)

Parametri

settings

EventSourceSettings

Combinazione bit per bit di valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

Commenti

Specificando settings quando viene costruito l'oggetto EventSource consente di specificare se l'evento viene scritto in base a un manifesto o in un formato autodescrizione. È inoltre possibile specificare che un'eccezione deve essere generata quando si verifica un errore durante il processo di scrittura degli eventi.

EventSource(String)

Origine:

TraceLoggingEventSource.cs

Crea una nuova istanza della classe EventSource con il nome specificato.

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)

Parametri

eventSourceName

String

Nome da applicare all'origine evento. Non deve essere null.

Eccezioni

ArgumentNullException

eventSourceName è null.

Commenti

Quando si usa questo costruttore, assicurarsi che l'argomento eventSourceName corrisponda al nome ETW definito dall'attributo EventSourceAttribute in tale tipo. In caso contrario, i GUID restituiti dalla Guid proprietà e il GetGuid(Type) metodo sarà diverso. Se i nomi dell'origine evento differiscono, la proprietà restituisce il Guid GUID usato per registrare questo oggetto EventSource con ETW.

EventSource(EventSourceSettings, String[])

Origine:

EventSource.cs

Inizializza una nuova istanza dell'oggetto EventSource da usare con eventi non di contratto che contengono le impostazioni e i tratti specificati.

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

Parametri

settings

EventSourceSettings

Combinazione bit per bit di valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

traits

String[]

Coppie chiave-valore che specificano i tratti per l'origine evento.

Eccezioni

ArgumentException

traits non è specificato nelle coppie chiave-valore.

Commenti

I tratti forniscono informazioni aggiuntive per un evento e vengono interpretati da un listener eventi. I tratti vengono specificati come coppie chiave-valore e, se non specificati in coppie, si verificherà un'eccezione. È possibile recuperare un tratto passando la chiave al GetTraitmetodo , .

Specificando settings quando viene costruito l'oggetto EventSource consente di specificare se l'evento viene scritto in base a un manifesto o in un formato autodescrizione. È inoltre possibile specificare che un'eccezione deve essere generata quando si verifica un errore durante il processo di scrittura degli eventi.

Vedi anche

• GetTrait(String)

EventSource(String, EventSourceSettings)

Origine:

TraceLoggingEventSource.cs

Crea una nuova istanza della classe EventSource con il nome e le impostazioni specificate.

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)

Parametri

eventSourceName

String

Nome da applicare all'origine evento. Non deve essere null.

config

EventSourceSettings

Combinazione bit per bit di valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

Eccezioni

ArgumentNullException

eventSourceName è null.

Commenti

Specificando settings quando viene costruito l'oggetto EventSource consente di specificare se l'evento viene scritto in base a un manifesto o in un formato autodescrizione. È inoltre possibile specificare che un'eccezione deve essere generata quando si verifica un errore durante il processo di scrittura degli eventi.

Quando si usa questo costruttore, assicurarsi che l'argomento eventSourceName corrisponda al nome ETW definito dall'attributo EventSourceAttribute in tale tipo. In caso contrario, i GUID restituiti dalla Guid proprietà e il GetGuid(Type) metodo sarà diverso.

In questi casi, la Guid proprietà restituisce il GUID usato per registrare questo oggetto EventSource con ETW.

EventSource(String, EventSourceSettings, String[])

Origine:

TraceLoggingEventSource.cs

Crea una nuova istanza della classe EventSource con le impostazioni di configurazione specificate.

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

Parametri

eventSourceName

String

Nome da applicare all'origine evento. Non deve essere null.

config

EventSourceSettings

Combinazione bit per bit di valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

traits

String[]

Coppie chiave-valore che specificano i tratti per l'origine evento.

Eccezioni

ArgumentNullException

eventSourceName è null.

ArgumentException

traits non è specificato nelle coppie chiave-valore.

Commenti

I tratti forniscono informazioni aggiuntive per un evento e vengono interpretati da un listener eventi. I tratti vengono specificati come coppie chiave-valore e, se non specificati in coppie, si verificherà un'eccezione. È possibile recuperare un tratto passando la chiave al GetTraitmetodo , .

Specificando config quando viene costruito l'oggetto EventSource consente di specificare se l'evento viene scritto in base a un manifesto o in un formato autodescrizione. È inoltre possibile specificare che un'eccezione deve essere generata quando si verifica un errore durante il processo di scrittura degli eventi.

Quando si usa questo costruttore, assicurarsi che l'argomento eventSourceName corrisponda al nome ETW definito dall'attributo EventSourceAttribute in tale tipo. In caso contrario, i GUID restituiti dalla Guid proprietà e il GetGuid(Type) metodo sarà diverso.

In questi casi, il GUID usato per registrare eventSource con ETW è quello restituito da Guid.

Vedi anche

• GetTrait(String)