Opções de rastreamento

Opções de rastreamento que você habilitar, desabilitar e filtrar a saída do rastreamento.Esses são objetos que existem no seu código e podem ser configurados externamente por meio de. arquivo de configuração.Existem três tipos de opções de rastreamento fornecidas no .NET estrutura: the BooleanSwitch classe, o TraceSwitch classe e o SourceSwitch classe. The BooleanSwitch classe atua sistema autônomo um comutador de alternância, ou ativar ou desativar uma variedade de instruções de rastreamento. The TraceSwitch e SourceSwitch classes permitem que você ative uma comutador de rastreamento para um nível de rastreamento específica para que o Trace ou TraceSource as mensagens especificadas para aquele nível e todos os níveis abaixo dela são exibidas. Se você desabilitar comutador, as mensagens de rastreamento não aparecerá.Todas essas classes derivam de resumo (MustInherit) classe comutador, sistema autônomo devem todos sistema autônomo switches desenvolvidos por usuário.

Opções de rastreamento podem ser útil para informações de filtragem.Por exemplo, convém ver todas as mensagens de rastreamento em um módulo de acesso de dados, mas as mensagens de erro apenas no restante do aplicativo.Nesse caso, você usaria um rastreamento comutador para o módulo de acesso de dados e um comutador para o restante do aplicativo.Usando o arquivo .config para configurar as opções para as configurações apropriadas, você pode controlar quais tipos de mensagem de rastreamento que você recebeu.Para obter mais informações, consulte Como: Criar e inicializar switches de rastreamento e Como: Configurar opções de rastreamento.

Normalmente, um aplicativo implantado é executado com seus switches desativados, para que sistema autônomo usuários não precisam observar muitas mensagens de rastreamento irrelevantes que aparecem em uma tela ou preenchimento de um arquivo de log sistema autônomo do aplicativo ser executado.Se surgir um problema durante a execução de aplicativos, interromper o aplicativo, ativar as opções e reinicie o aplicativo.Em seguida, as mensagens de rastreamento serão exibidas.

Para usar uma comutador você deve criar primeiro um objeto de comutador de um BooleanSwitch class, a TraceSwitch classe, ou uma classe de comutador definidas pelo desenvolvedor.Para obter mais informações sobre criar opções definidas pelo desenvolvedor, consulte Classe de comutador na referência do .NET estrutura.Em seguida, você pode conjunto um valor de configuração que especifica quando o objeto do comutador estiver para ser usado.Você então testar a configuração do objeto comutador vários Rastreamento (or Depurar) métodos de rastreamento.

Níveis de rastreamento

Quando você usa TraceSwitch, existem considerações adicionais.A TraceSwitch objeto tem quatro propriedades que retornam booliano valores indicando se o comutador está definido para pelo menos um nível específico:

• Propriedade TraceSwitch.TraceError

• Propriedade TraceSwitch.TraceWarning

• Propriedade TraceSwitch.TraceInfo

• Propriedade TraceSwitch.TraceVerbose

Níveis permitem que você limite a quantidade de informações de rastreamento que você recebe a apenas essas informações necessárias para resolver um problema.Especificar o nível de detalhes desejado na saída de rastreamento, definindo e configurando o rastreamento alterna para o nível de rastreamento apropriada.Você pode receber mensagens de erro, mensagens de aviso Informativo mensagens, mensagens de rastreamento verbose ou nenhuma mensagem de todos.

Ele é totalmente você decida que tipo de mensagem para associar cada nível.Normalmente, o conteúdo das mensagens de rastreamento depende do que você associar cada nível, mas determinar as diferenças entre os níveis.Convém fornecem descrições detalhadas de um problema no nível 3 (Info), por exemplo, mas fornecem apenas um número de referência de erro no nível 1 (Erro).Ele é inteiramente a decidir qual esquema funciona melhor em seu aplicativo.

Essas propriedades correspondem aos valores 1 a 4 do TraceLevel enumeração.A tabela a seguir lista os níveis do TraceLevel enumeração e seus valores.

The TraceSwitch propriedades indicam o nível de rastreamento máximo para o comutador.Ou seja, sistema autônomo informações de rastreamento foi escritas para o nível especificado, bem sistema autônomo para todos sistema autônomo níveis inferiores.Por exemplo, se TraceInfo is True, then TraceError and TraceWarning are also True but TraceVerbose também pode ser False.

Essas propriedades são somente leitura.The TraceSwitch objeto define-os automaticamente quando o TraceLevel propriedade é definida.Por exemplo:

Dim myTraceSwitch As New TraceSwitch("SwitchOne", "The first switch")
myTraceSwitch.Level = TraceLevel.Info
' This message box displays true, becuase setting the level to
' TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(myTraceSwitch.TraceWarning.ToString())
' This messagebox displays false.
MessageBox.Show(myTraceSwitch.TraceVerbose.ToString())

System.Diagnostics.TraceSwitch myTraceSwitch = 
   new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch");
myTraceSwitch.Level = System.Diagnostics.TraceLevel.Info;
// This message box displays true, becuase setting the level to 
// TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(myTraceSwitch.TraceWarning.ToString());
// This message box displays false.
MessageBox.Show(myTraceSwitch.TraceVerbose.ToString());

System.Diagnostics.TraceSwitch myTraceSwitch =
   new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch");
myTraceSwitch.set_Level(System.Diagnostics.TraceLevel.Info);
// This message box displays true, becuase setting the level to 
// TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(Convert.ToString(myTraceSwitch.get_TraceWarning()));
// This message box displays false.
MessageBox.Show(Convert.ToString(myTraceSwitch.get_TraceVerbose()));}

Opções definidas pelo desenvolvedor

Bem como fornecendo BooleanSwitch and TraceSwitch, você pode definir seus próprios switches, herdam o comutador classe e substituindo os métodos da classe base com métodos personalizados.Para obter mais informações sobre criar opções definidas pelo desenvolvedor, consulte Classe de comutador na referência do .NET estrutura.

Consulte também

Tarefas

Como: Adicionar instruções de rastreamento ao código do aplicativo

Como: Configurar opções de rastreamento

Conceitos

Ouvintes de rastreamento

Introdução à instrumentação e rastreamento

Outros recursos

Rastreamento e intrumentando aplicações