SourceSwitch Classe

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origem:

SourceSwitch.cs

Fornece uma opção em vários níveis para controlar o rastreamento e depurar a saída sem recompilar o código.

public ref class SourceSwitch : System::Diagnostics::Switch

public class SourceSwitch : System.Diagnostics.Switch

type SourceSwitch = class
    inherit Switch

Public Class SourceSwitch
Inherits Switch

Herança

Object

Switch

SourceSwitch

Comentários

A Switch propriedade da TraceSource classe é um SourceSwitch objeto . A SourceSwitch classe fornece uma Level propriedade para testar o nível de evento da opção. A Level propriedade obtém ou define o valor da TraceLevel opção.

Você pode definir o nível de evento de um SourceSwitch por meio do arquivo de configuração do aplicativo e, em seguida, usar o nível configurado SourceSwitch em seu aplicativo. Como alternativa, você pode criar um SourceSwitch em seu código e definir o nível diretamente para instrumentar uma seção específica do código.

Para configurar um SourceSwitch, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode definir o valor de uma opção ou limpar todas as opções definidas anteriormente pelo aplicativo. O arquivo de configuração deve ser formatado conforme mostrado no exemplo a seguir.

<switches>  
  <add name="SourceSwitch" value="Verbose"></add>  
</switches>  

A opção é usada para marcar se um rastreamento deve ser propagado ou ignorado. Cada TraceSource método de rastreamento chama o ShouldTrace método antes de chamar os ouvintes. Se o ShouldTrace método retornar false, o rastreamento será ignorado e o método de rastreamento será encerrado. Se o ShouldTrace método retornar true, o rastreamento será passado para os ouvintes.

Construtores

SourceSwitch(String)	Inicializa uma nova instância da classe SourceSwitch, especificando o nome da fonte.
SourceSwitch(String, String)	Inicializa uma nova instância da classe SourceSwitch, especificando um nome de exibição e o valor padrão para o comutador de origem.

Propriedades

Attributes	Obtém os atributos de opção personalizados definidos no arquivo de configuração de aplicativo. (Herdado de Switch)
DefaultValue	Obtém o valor padrão atribuído no construtor. (Herdado de Switch)
Description	Obtém uma descrição do comutador. (Herdado de Switch)
DisplayName	Obtém o nome usado para identificar o comutador. (Herdado de Switch)
Level	Obtém ou define o nível do comutador.
SwitchSetting	Obtém ou define a configuração atual para essa opção. (Herdado de Switch)
Value	Obtém ou define o valor da opção. (Herdado de Switch)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetSupportedAttributes()	Obtém os atributos personalizados com suporte do comutador. (Herdado de Switch)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnSwitchSettingChanged()	Invocado quando a propriedade SwitchSetting é alterada. (Herdado de Switch)
OnValueChanged()	Invocado quando o valor da propriedade Value muda.
Refresh()	Atualiza os dados de configuração de rastreamento. (Herdado de Switch)
ShouldTrace(TraceEventType)	Determina se os ouvintes de rastreamento devem ser chamados, com base no tipo de evento de rastreamento.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)