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 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
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Cria uma nova instância da classe EventSource.
protected:
EventSource();protected EventSource ();Protected Sub New ()Aplica-se a
EventSource(Boolean)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- 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.EventSourceProtected 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.
Aplica-se a
EventSource(EventSourceSettings)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- 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.EventSourceProtected 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.
Aplica-se a
EventSource(String)
- Origem:
- TraceLoggingEventSource.cs
- Origem:
- TraceLoggingEventSource.cs
- 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.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 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.
Aplica-se a
EventSource(EventSourceSettings, String[])
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- 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);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 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
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
Aplica-se a
EventSource(String, EventSourceSettings)
- Origem:
- TraceLoggingEventSource.cs
- Origem:
- TraceLoggingEventSource.cs
- 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.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 especifica as definições de configuração 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 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.
Aplica-se a
EventSource(String, EventSourceSettings, String[])
- Origem:
- TraceLoggingEventSource.cs
- Origem:
- TraceLoggingEventSource.cs
- 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);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 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
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 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.
