EventSource Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma nova instância da EventSource classe.
Sobrecargas
| Nome | Description |
|---|---|
| EventSource() |
Cria uma nova instância da EventSource classe. |
| EventSource(Boolean) |
Cria uma nova instância da classe EventSource e especifica se uma exceção será gerada quando ocorrer um erro no código de Windows subjacente. |
| EventSource(EventSourceSettings) |
Cria uma nova instância da EventSource classe com as configurações especificadas. |
| EventSource(String) |
Cria uma nova instância da EventSource classe com o nome especificado. |
| EventSource(EventSourceSettings, String[]) |
Inicializa uma nova instância da EventSource a ser usada com eventos sem contrato que contêm as configurações e características especificadas. |
| EventSource(String, EventSourceSettings) |
Cria uma nova instância da EventSource classe com o nome e as configurações especificados. |
| EventSource(String, EventSourceSettings, String[]) |
Cria uma nova instância da EventSource classe com as configurações 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 uma exceção será gerada quando ocorrer um erro no código de Windows subjacente.
protected:
EventSource(bool throwOnEventWriteErrors);protected EventSource(bool throwOnEventWriteErrors);new System.Diagnostics.Tracing.EventSource : bool -> System.Diagnostics.Tracing.EventSourceProtected Sub New (throwOnEventWriteErrors As Boolean)Parâmetros
- throwOnEventWriteErrors
- Boolean
true para gerar uma exceção quando ocorrer um erro no código de Windows subjacente; caso contrário, false.
Aplica-se a
EventSource(EventSourceSettings)
Cria uma nova instância da EventSource classe com as configurações 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.EventSourceProtected Sub New (settings As EventSourceSettings)Parâmetros
- settings
- EventSourceSettings
Uma combinação bit a bit dos valores de enumeração que especificam as configurações 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 autodescrevendo. 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.
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.EventSourcePublic Sub New (eventSourceName As String)Parâmetros
- eventSourceName
- String
O nome a ser aplicado à origem do evento. Não deve ser null.
Exceções
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 o 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.
Aplica-se a
EventSource(EventSourceSettings, String[])
Inicializa uma nova instância da EventSource a ser usada com eventos sem 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.EventSourceProtected 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 configurações a serem aplicadas à origem do evento.
- traits
- String[]
Os pares chave-valor que especificam características para a origem do evento.
Exceções
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 autodescrevendo. 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
Aplica-se a
EventSource(String, EventSourceSettings)
Cria uma nova instância da EventSource classe 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.EventSourcePublic 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 especificam as configurações a serem aplicadas à origem do evento.
Exceções
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 autodescrevendo. 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 o GetGuid(Type) método serão diferentes.
Nesses casos, a Guid propriedade retorna o GUID usado para registrar este EventSource com ETW.
Aplica-se a
EventSource(String, EventSourceSettings, String[])
Cria uma nova instância da EventSource classe com as configurações 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.EventSourcePublic 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 especificam as configurações a serem aplicadas à origem do evento.
- traits
- String[]
Os pares chave-valor que especificam características para a origem do evento.
Exceções
eventSourceName é null.
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 autodescrevendo. 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 o GetGuid(Type) método serão diferentes.
Nesses casos, o GUID usado para registrar esse EventSource com ETW é aquele retornado por Guid.