EventSource Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.