EventSource Construtores

Definição

Namespace:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Cria uma nova instância da classe EventSource.

Sobrecargas

EventSource()	Cria uma nova instância da classe EventSource.
EventSource(Boolean)	Cria uma nova instância da classe EventSource e especifica se uma exceção deve ser gerada quando ocorre um erro no código do Windows subjacente.
EventSource(EventSourceSettings)	Cria uma nova instância da classe EventSource com as definições de configuração especificadas.
EventSource(String)	Cria uma nova instância da classe EventSource com o nome especificado.
EventSource(EventSourceSettings, String[])	Inicializa uma nova instância do EventSource a ser usada com eventos que não são de contrato que contém as configurações e características especificadas.
EventSource(String, EventSourceSettings)	Cria uma nova instância da classe EventSource com o nome e as configurações especificados.
EventSource(String, EventSourceSettings, String[])	Cria uma nova instância da classe EventSource com as definições de configuração especificadas.

EventSource()

Origem:

EventSource.cs

Cria uma nova instância da classe EventSource.

protected:
 EventSource();

protected EventSource ();

Protected Sub New ()

EventSource(Boolean)

Origem:

EventSource.cs

Cria uma nova instância da classe EventSource e especifica se uma exceção deve ser gerada quando ocorre um erro no código do Windows subjacente.

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 gerar uma exceção quando ocorre um erro no código subjacente do Windows; caso contrário, false.

EventSource(EventSourceSettings)

Origem:

EventSource.cs

Cria uma nova instância da classe EventSource com as definições de configuração 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

Uma combinação bit a bit dos valores de enumeração que especifica as definições de configuração a serem aplicadas à origem do evento.

Comentários

Especificar settings quando o EventSource é construído permite que você especifique se o evento é escrito em um formato baseado em manifesto ou autodescritivo. Além disso, você pode especificar que uma exceção deve ser gerada quando ocorrer um erro durante o processo de gravação de eventos.

EventSource(String)

Origem:

TraceLoggingEventSource.cs

Cria uma nova instância da classe EventSource com o nome 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

O nome a ser aplicado à origem do evento. Não deve ser null.

Exceções

ArgumentNullException

eventSourceName é null.

Comentários

Ao usar esse construtor, verifique se o eventSourceName argumento corresponde ao nome ETW definido pelo EventSourceAttribute atributo nesse tipo. Caso contrário, os GUIDs retornados pela Guid propriedade e pelo GetGuid(Type) método serão diferentes. Se os nomes de origem do evento forem diferentes, a Guid propriedade retornará o GUID usado para registrar este EventSource com ETW.

EventSource(EventSourceSettings, String[])

Origem:

EventSource.cs

Inicializa uma nova instância do EventSource a ser usada com eventos que não são de contrato que contém as configurações e características especificadas.

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

Uma combinação bit a bit dos valores de enumeração que especifica as definições de configuração a serem aplicadas à origem do evento.

traits

String[]

Os pares chave-valor que especificam características para a origem do evento.

Exceções

ArgumentException

traits não é especificado em pares chave-valor.

Comentários

As características fornecem informações adicionais para um evento e são interpretadas por um ouvinte de eventos. As características são especificadas como pares chave-valor e, se não forem especificadas em pares, ocorrerá uma exceção. Você pode recuperar uma característica passando a chave para o GetTraitmétodo , .

Especificar settings quando o EventSource é construído permite que você especifique se o evento é escrito em um formato baseado em manifesto ou autodescritivo. Além disso, você pode especificar que uma exceção deve ser gerada quando ocorrer um erro durante o processo de gravação de eventos.

Confira também

• GetTrait(String)

EventSource(String, EventSourceSettings)

Origem:

TraceLoggingEventSource.cs

Cria uma nova instância da classe EventSource com o nome e as configurações 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

O nome a ser aplicado à origem do evento. Não deve ser null.

config

EventSourceSettings

Uma combinação bit a bit dos valores de enumeração que especifica as definições de configuração a serem aplicadas à origem do evento.

Exceções

ArgumentNullException

eventSourceName é null.

Comentários

Especificar settings quando o EventSource é construído permite que você especifique se o evento é escrito em um formato baseado em manifesto ou autodescritivo. Além disso, você pode especificar que uma exceção deve ser gerada quando ocorrer um erro durante o processo de gravação de eventos.

Ao usar esse construtor, verifique se o eventSourceName argumento corresponde ao nome ETW definido pelo EventSourceAttribute atributo nesse tipo. Caso contrário, os GUIDs retornados pela Guid propriedade e pelo GetGuid(Type) método serão diferentes.

Nesses casos, a Guid propriedade retorna o GUID usado para registrar esse EventSource com ETW.

EventSource(String, EventSourceSettings, String[])

Origem:

TraceLoggingEventSource.cs

Cria uma nova instância da classe EventSource com as definições de configuração 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

O nome a ser aplicado à origem do evento. Não deve ser null.

config

EventSourceSettings

Uma combinação bit a bit dos valores de enumeração que especifica as definições de configuração a serem aplicadas à origem do evento.

traits

String[]

Os pares chave-valor que especificam características para a origem do evento.

Exceções

ArgumentNullException

eventSourceName é null.

ArgumentException

traits não é especificado em pares chave-valor.

Comentários

As características fornecem informações adicionais para um evento e são interpretadas por um ouvinte de eventos. As características são especificadas como pares chave-valor e, se não forem especificadas em pares, ocorrerá uma exceção. Você pode recuperar uma característica passando a chave para o GetTraitmétodo , .

Especificar config quando o EventSource é construído permite que você especifique se o evento é escrito em um formato baseado em manifesto ou autodescritivo. Além disso, você pode especificar que uma exceção deve ser gerada quando ocorrer um erro durante o processo de gravação de eventos.

Ao usar esse construtor, verifique se o eventSourceName argumento corresponde ao nome ETW definido pelo EventSourceAttribute atributo nesse tipo. Caso contrário, os GUIDs retornados pela Guid propriedade e pelo GetGuid(Type) método serão diferentes.

Nesses casos, o GUID usado para registrar esse EventSource com ETW é aquele retornado por Guid.

Confira também

• GetTrait(String)