EventSource Costruttori

Definizione

Crea una nuova istanza della EventSource classe .

Overload

Nome Descrizione
EventSource()

Crea una nuova istanza della EventSource classe .

EventSource(Boolean)

Crea una nuova istanza della classe EventSource e specifica se generare un'eccezione quando si verifica un errore nel codice Windows sottostante.

EventSource(EventSourceSettings)

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

EventSource(String)

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

EventSource(EventSourceSettings, String[])

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

EventSource(String, EventSourceSettings)

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

EventSource(String, EventSourceSettings, String[])

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

EventSource()

Crea una nuova istanza della EventSource classe .

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

Si applica a

EventSource(Boolean)

Crea una nuova istanza della classe EventSource e specifica se generare un'eccezione quando si verifica un errore nel codice Windows sottostante.

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 Windows sottostante; in caso contrario, false.

Si applica a

EventSource(EventSourceSettings)

Crea una nuova istanza della EventSource classe 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 dei valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

Commenti

settings Se si specifica quando viene costruito , EventSource è possibile specificare se l'evento viene scritto in un formato basato su manifesto o autodescrittura. Inoltre, è possibile specificare che deve essere generata un'eccezione quando si verifica un errore durante il processo di scrittura degli eventi.

Si applica a

EventSource(String)

Crea una nuova istanza della EventSource classe 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

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 saranno diversi. Se i nomi delle origini eventi differiscono, la Guid proprietà restituisce il GUID usato per registrare eventSource con ETW.

Si applica a

EventSource(EventSourceSettings, String[])

Inizializza una nuova istanza dell'oggetto EventSource da utilizzare con eventi non contrattuali 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 dei valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

traits
String[]

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

Eccezioni

traits non è specificato nelle coppie chiave-valore.

Commenti

Le caratteristiche forniscono informazioni aggiuntive per un evento e vengono interpretate da un listener di 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 , .

settings Se si specifica quando viene costruito , EventSource è possibile specificare se l'evento viene scritto in un formato basato su manifesto o autodescrittura. Inoltre, è possibile specificare che deve essere generata un'eccezione quando si verifica un errore durante il processo di scrittura degli eventi.

Vedi anche

Si applica a

EventSource(String, EventSourceSettings)

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

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 dei valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

Eccezioni

eventSourceName è null.

Commenti

settings Se si specifica quando viene costruito , EventSource è possibile specificare se l'evento viene scritto in un formato basato su manifesto o autodescrittura. Inoltre, è possibile specificare che deve essere generata un'eccezione 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 saranno diversi.

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

Si applica a

EventSource(String, EventSourceSettings, String[])

Crea una nuova istanza della EventSource classe 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 dei valori di enumerazione che specificano le impostazioni di configurazione da applicare all'origine evento.

traits
String[]

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

Eccezioni

eventSourceName è null.

traits non è specificato nelle coppie chiave-valore.

Commenti

Le caratteristiche forniscono informazioni aggiuntive per un evento e vengono interpretate da un listener di 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 , .

config Se si specifica quando viene costruito , EventSource è possibile specificare se l'evento viene scritto in un formato basato su manifesto o autodescrittura. Inoltre, è possibile specificare che deve essere generata un'eccezione 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 saranno diversi.

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

Vedi anche

Si applica a