Partilhar via


SourceSwitch Classe

Definição

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
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)

Aplica-se a