EventSource Construtores

Definição

Espaço de Nomes:: System.Diagnostics.Tracing

Assemblagens:: mscorlib.dll, System.Diagnostics.Tracing.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Diagnostics.Tracing.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria uma nova instância da EventSource classe.

Sobrecargas

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

EventSource()

Cria uma nova instância da EventSource classe.

protected:
 EventSource();

protected EventSource();

Protected Sub New ()

Aplica-se a

EventSource(Boolean)

Cria uma nova instância da classe EventSource e especifica se deve lançar uma exceção quando ocorre um erro no código 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 lançar uma exceção quando ocorre um erro no código Windows subjacente; caso contrário, false.

Aplica-se a

EventSource(EventSourceSettings)

Cria uma nova instância da EventSource classe 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 especificam as definições de configuração a aplicar à fonte do evento.

Observações

Especificar settings quando o EventSource é construído permite-lhe especificar se o evento está escrito num formato baseado em manifestos ou auto-descritivo. Além disso, pode especificar que uma exceção deve ser criada quando ocorre um erro durante o processo de escrita do evento.

Aplica-se a

EventSource(String)

Cria uma nova instância da EventSource classe 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 aplicar à fonte do evento. Não deve ser null.

Exceções

ArgumentNullException

eventSourceName é null.

Observações

Ao usar este construtor, certifique-se de que o eventSourceName argumento corresponde ao nome ETW definido pelo EventSourceAttribute atributo nesse tipo. Caso contrário, os GUIDs devolvidos pela Guid propriedade e pelo GetGuid(Type) método serão diferentes. Se os nomes das fontes dos eventos diferirem, a Guid propriedade devolve o GUID usado para registar este EventSource com o ETW.

Aplica-se a

EventSource(EventSourceSettings, String[])

Inicializa uma nova instância do EventSource a ser usada com eventos não contratuais que contenha as definiçõ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 especificam as definições de configuração a aplicar à fonte do evento.

traits: String[]

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

Exceções

ArgumentException

traits não está especificado em pares-chave-valor.

Observações

Os traços fornecem informação adicional para um evento e são interpretados por um ouvinte do evento. As características são especificadas como pares-chave-valor e, se não forem especificadas em pares, ocorrerá uma exceção. Podes recuperar uma característica passando a chave para o GetTraitmétodo , .

Ver também

GetTrait(String)

Aplica-se a

EventSource(String, EventSourceSettings)

Cria uma nova instância da EventSource classe com o nome e as definiçõ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 aplicar à fonte do evento. Não deve ser null.

config: EventSourceSettings

Uma combinação bit a bit dos valores de enumeração que especificam as definições de configuração a aplicar à fonte do evento.

Exceções

ArgumentNullException

eventSourceName é null.

Observações

Nesses casos, a Guid propriedade devolve o GUID usado para registar este EventSource com o ETW.

Aplica-se a

EventSource(String, EventSourceSettings, String[])

Cria uma nova instância da EventSource classe 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 aplicar à fonte do evento. Não deve ser null.

config: EventSourceSettings

Uma combinação bit a bit dos valores de enumeração que especificam as definições de configuração a aplicar à fonte do evento.

traits: String[]

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

Exceções

ArgumentNullException

eventSourceName é null.

ArgumentException

traits não está especificado em pares-chave-valor.

Observações

Especificar config quando o EventSource é construído permite-lhe especificar se o evento está escrito num formato baseado em manifestos ou auto-descritivo. Além disso, pode especificar que uma exceção deve ser criada quando ocorre um erro durante o processo de escrita do evento.

Nesses casos, o GUID usado para registar este EventSource com ETW é o que retorna por Guid.

Ver também

GetTrait(String)

Aplica-se a

Comentários

Esta página foi útil?