EventSource Constructores

Definición

Espacio de nombres:

System.Diagnostics.Tracing

Ensamblado:

System.Diagnostics.Tracing.dll

Crea una nueva instancia de la clase EventSource.

Sobrecargas

EventSource()	Crea una nueva instancia de la clase EventSource.
EventSource(Boolean)	Crea una nueva instancia de la clase EventSource y especifica si se inicia una excepción cuando se produce un error en el código subyacente de Windows.
EventSource(EventSourceSettings)	Crea una instancia de la clase EventSource con las opciones de configuración especificadas.
EventSource(String)	Crea una nueva instancia de la clase EventSource con el nombre especificado.
EventSource(EventSourceSettings, String[])	Inicializa una nueva instancia del EventSource para su uso con eventos que no forman parte de un contrato y contengan las características y rasgos especificados.
EventSource(String, EventSourceSettings)	Crea una nueva instancia de la clase EventSource con el nombre y configuración especificados.
EventSource(String, EventSourceSettings, String[])	Crea una instancia de la clase EventSource con las opciones de configuración especificadas.

EventSource()

Source:

EventSource.cs

Crea una nueva instancia de la clase EventSource.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Source:

EventSource.cs

Crea una nueva instancia de la clase EventSource y especifica si se inicia una excepción cuando se produce un error en el código subyacente de 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)

Parámetros

throwOnEventWriteErrors

Boolean

true para producir una excepción cuando se produce un error en el código subyacente de Windows; si no, false.

EventSource(EventSourceSettings)

Source:

EventSource.cs

Crea una instancia de la clase EventSource con las opciones de configuración especificadas.

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)

Parámetros

settings

EventSourceSettings

Combinación bit a bit de los valores de enumeración que especifican los valores de configuración que se van a aplicar al origen del evento.

Comentarios

Especificar settings cuándo EventSource se construye permite especificar si el evento se escribe en un formato basado en manifiesto o en un formato autodescriptible. Además, puede especificar que se debe generar una excepción cuando se produzca un error durante el proceso de escritura de eventos.

EventSource(String)

Source:

TraceLoggingEventSource.cs

Crea una nueva instancia de la clase EventSource con el nombre especificado.

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)

Parámetros

eventSourceName

String

Nombre que se va a aplicar al origen del evento. No debe ser null.

Excepciones

ArgumentNullException

eventSourceName es null.

Comentarios

Al usar este constructor, asegúrese de que el eventSourceName argumento coincide con el nombre ETW definido por el EventSourceAttribute atributo en ese tipo. De lo contrario, los GUID devueltos por la Guid propiedad y el GetGuid(Type) método serán diferentes. Si los nombres de origen del evento difieren, la Guid propiedad devuelve el GUID usado para registrar este EventSource con ETW.

EventSource(EventSourceSettings, String[])

Source:

EventSource.cs

Inicializa una nueva instancia del EventSource para su uso con eventos que no forman parte de un contrato y contengan las características y rasgos especificados.

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

Parámetros

settings

EventSourceSettings

Combinación bit a bit de los valores de enumeración que especifican los valores de configuración que se van a aplicar al origen del evento.

traits

String[]

Los pares clave-valor que especifican rasgos para el origen del evento.

Excepciones

ArgumentException

traits no está especificado en pares clave-valor.

Comentarios

Los rasgos proporcionan información adicional para un evento y los interpreta un agente de escucha de eventos. Los rasgos se especifican como pares clave-valor y, si no se especifican en pares, se producirá una excepción. Para recuperar un rasgo, pase la clave al GetTraitmétodo , .

Especificar settings cuándo EventSource se construye permite especificar si el evento se escribe en un formato basado en manifiesto o en un formato autodescriptible. Además, puede especificar que se debe generar una excepción cuando se produzca un error durante el proceso de escritura de eventos.

Consulte también

• GetTrait(String)

EventSource(String, EventSourceSettings)

Source:

TraceLoggingEventSource.cs

Crea una nueva instancia de la clase EventSource con el nombre y configuración especificados.

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)

Parámetros

eventSourceName

String

Nombre que se va a aplicar al origen del evento. No debe ser null.

config

EventSourceSettings

Combinación bit a bit de los valores de enumeración que especifican los valores de configuración que se van a aplicar al origen del evento.

Excepciones

ArgumentNullException

eventSourceName es null.

Comentarios

Especificar settings cuándo EventSource se construye permite especificar si el evento se escribe en un formato basado en manifiesto o en un formato autodescriptible. Además, puede especificar que se debe generar una excepción cuando se produzca un error durante el proceso de escritura de eventos.

Al usar este constructor, asegúrese de que el eventSourceName argumento coincide con el nombre ETW definido por el EventSourceAttribute atributo en ese tipo. De lo contrario, los GUID devueltos por la Guid propiedad y el GetGuid(Type) método serán diferentes.

En tales casos, la Guid propiedad devuelve el GUID usado para registrar este EventSource con ETW.

EventSource(String, EventSourceSettings, String[])

Source:

TraceLoggingEventSource.cs

Crea una instancia de la clase EventSource con las opciones de configuración especificadas.

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

Parámetros

eventSourceName

String

Nombre que se va a aplicar al origen del evento. No debe ser null.

config

EventSourceSettings

Combinación bit a bit de los valores de enumeración que especifican los valores de configuración que se van a aplicar al origen del evento.

traits

String[]

Los pares clave-valor que especifican rasgos para el origen del evento.

Excepciones

ArgumentNullException

eventSourceName es null.

ArgumentException

traits no está especificado en pares clave-valor.

Comentarios

Los rasgos proporcionan información adicional para un evento y los interpreta un agente de escucha de eventos. Los rasgos se especifican como pares clave-valor y, si no se especifican en pares, se producirá una excepción. Para recuperar un rasgo, pase la clave al GetTraitmétodo , .

Especificar config cuándo EventSource se construye permite especificar si el evento se escribe en un formato basado en manifiesto o en un formato autodescriptible. Además, puede especificar que se debe generar una excepción cuando se produzca un error durante el proceso de escritura de eventos.

Al usar este constructor, asegúrese de que el eventSourceName argumento coincide con el nombre ETW definido por el EventSourceAttribute atributo en ese tipo. De lo contrario, los GUID devueltos por la Guid propiedad y el GetGuid(Type) método serán diferentes.

En tales casos, el GUID usado para registrar este EventSource con ETW es el devuelto por Guid.

Consulte también

• GetTrait(String)