Compartilhar via


Como: Criar e inicializar opção de rastreamento

Para usar opções de rastreamento, você deve primeiro criá-los e colocá-los em seu código. Há duas classes predefinidas do qual você pode criar objetos de switch: o BooleanSwitch classe e o TraceSwitch classe. Você usaria BooleanSwitch se você só se preocupa ou não será exibida uma mensagem de rastreamento; Você usaria TraceSwitch se necessário distinguir os níveis de rastreamento. Se um TraceSwitch é usado você pode definir suas próprias mensagens de depuração e associá-los a níveis de rastreamento diferente. Você pode usar ambos os tipos de switch com rastreamento ou depuração. Por padrão, um BooleanSwitch está desativado e um TraceSwitch estiver definido como nível TraceLevel.Off. Opções de rastreamento podem ser criadas e colocadas em qualquer parte do código que pode utilizá-los.

Embora você possa definir níveis de rastreamento e outras opções de configuração no código, é recomendável que você use o arquivo de configuração para gerenciar o estado de suas opções. Isso ocorre porque a configuração dos switches de gerenciamento no sistema de configuração permite maior flexibilidade — você pode ativar e desativar vários switches e alterar os níveis sem recompilar seu aplicativo. Para obter mais informações, consulte Configurar opções de rastreamento.

Criar e inicializar um opção de rastreamento

  1. Definir um switch como qualquer tipo de BooleanSwitch ou o tipo de TraceSwitch e definir o nome e descrição do switch.

  2. Configure o comutador de rastreamento. Para obter mais informações, consulte Configurar opções de rastreamento.

    O código a seguir cria dois switches, um de cada tipo:

    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module")
    Dim generalSwitch As New TraceSwitch("General", "Entire application")
    
    System.Diagnostics.BooleanSwitch dataSwitch = 
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch = 
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    
    System.Diagnostics.BooleanSwitch dataSwitch =
       new System.Diagnostics.BooleanSwitch("Data", "DataAccess module");
    System.Diagnostics.TraceSwitch generalSwitch =
       new System.Diagnostics.TraceSwitch("General", 
       "Entire application");
    

Consulte também

Tarefas

Como: Configurar opções de rastreamento

Conceitos

Opções de rastreamento.

Introdução à instrumentação e rastreamento