SourceSwitch Classe
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.
Fornece uma opção multinível para controlar o rastreamento e a saída de depuração sem recompilar seu código.
public ref class SourceSwitch : System::Diagnostics::Switchpublic class SourceSwitch : System.Diagnostics.Switchtype SourceSwitch = class
inherit SwitchPublic Class SourceSwitch
Inherits Switch- Herança
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 no código e definir o nível diretamente para instrumentar uma seção específica do código.
Para configurar um SourceSwitcharquivo de configuração, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode definir o valor de um comutador 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 verificar 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
| Nome | Description |
|---|---|
| SourceSwitch(String, String) |
Inicializa uma nova instância da SourceSwitch classe, especificando o nome de exibição e o valor padrão para a opção de origem. |
| SourceSwitch(String) |
Inicializa uma nova instância da SourceSwitch classe, especificando o nome da origem. |
Propriedades
| Nome | Description |
|---|---|
| Attributes |
Obtém os atributos de comutador personalizados definidos no arquivo de configuração do aplicativo. (Herdado de Switch) |
| DefaultValue |
Obtém o valor padrão atribuído no construtor. (Herdado de Switch) |
| Description |
Obtém uma descrição da opção. (Herdado de Switch) |
| DisplayName |
Obtém um nome usado para identificar a opção. (Herdado de Switch) |
| Level |
Obtém ou define o nível da opção. |
| 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
| Nome | Description |
|---|---|
| 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 compatíveis com a opção. (Herdado de Switch) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnSwitchSettingChanged() |
Invocado quando a SwitchSetting propriedade é alterada. (Herdado de Switch) |
| OnValueChanged() |
Invocado quando o valor da Value propriedade é alterado. |
| 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) |
