Como: Configurar opções de rastreamento
Depois que seu aplicativo tiver sido distribuído, você pode habilitar ou desabilitar a saída de rastreamento ao configurar as opções de rastreamento em seu aplicativo.Configurar um comutador significa alterando seu valor de uma fonte externa após ter sido inicializada.Você pode alterar os valores dos objetos de comutador usando o arquivo de configuração.Configurar um comutador de rastreamento para ativar e desativar o ele ou conjunto seu nível, determinar a quantidade e digitá-lo de mensagens passa para ouvintes.
Os switches são configurados usando o arquivo .config.Para um aplicativo da Web, ele é o arquivo web.config associado ao projeto.Em um aplicativos do Windows, este arquivo é nomeado (nome do aplicativo). exe.config.Um aplicativo implantado, esse arquivo deve residir na mesma pasta que o executável.
Quando seu aplicativo executa o código que cria uma instância de um comutador para o primeiro time, ele verifica o arquivo de configuração para o nível de rastreamento informações sobre o comutador nomeado.O sistema de rastreamento examina o arquivo de configuração apenas uma vez para qualquer comutador específico — a primeira vez que seu aplicativo cria o comutador.
Em um aplicativo implantado, você pode habilitar código de rastreamento reconfigurando comutador objetos quando seu aplicativo não estiver sendo executado.Normalmente, isso envolve ativando os objetos de comutador e desativar ou alterando os níveis de rastreamento e, em seguida, reiniciar o aplicativo.
Quando você cria uma instância de um comutador, você também inicializá-lo especificando dois argumentos: a displayName argumento e um Descrição argumento.The displayName argumento do construtor define o Switch.DisplayName propriedade das Switch instância de classe. The displayName é o nome que é usado para configurar o comutador a. arquivo de configuração e o Descrição argumento deve retornar uma breve descrição do comutador e quais mensagens controles.
Como especificar o nome de um comutador para configurar, também deverá especificar um valor para o comutador.Esse valor é um inteiro.For BooleanSwitch, o valor 0 corresponde ao Logoffe qualquer valor diferente de zero corresponde a Em.For TraceSwitchcorrespondem 0,1,2,3 e 4 Logoff, Erro, Aviso, Info, and Verbose, respectivamente.Qualquer número maior que 4 é tratado sistema autônomo Verbosee qualquer número inferior a zero é tratado sistema autônomo Logoff.
.gif "Observação") Observação: |
|---|
No .NET estrutura versão 2.0, você pode usar texto Para especificar o valor de um comutador.Por exemplo, true para um BooleanSwitch ou o texto que representa um valor de enumeração sistema autônomo Error para um TraceSwitch. A linha <add name="myTraceSwitch" value="Error" /> é equivalente a <add name="myTraceSwitch" value="1" />. |
Em ordem para que os usuários finais poderá configurar opções de rastreamento do aplicativo, você deve fornecer documentação detalhada sobre as opções em seu aplicativo.Você deve detalham quais opções controlam o que e como ativar e desativar o-los.Você também deve fornecer seu usuário participante com um. arquivo de configuração com ajuda apropriada nos comentários.
Para criar e configurar opções de rastreamento
Crie seus comutadores no código.Para obter mais informações, consulte Criando e inicializando switches de rastreamento.
Se seu projeto não contiver um arquivo de configuração (app.config ou Web.config), depois do Projeto menu, selecionar Adicionar novo item.
Visual Basic: No Adicionar novo item caixa de diálogo, choose Arquivo de configuração do aplicativo.
O arquivo de configuração do aplicativo é criado e aberto.Este é um documento XML cujo elemento raiz é <configuration>.
Translation from VPE for Csharp Visual: No Adicionar novo item diálogo caixa, escolher Arquivo XML.Nomear esse arquivo App.config.No editor de XML, após a declaração XML, adicione o seguinte XML:
<configuration> </configuration>Quando seu projeto for compilado, o App. arquivo de configuração é copiado para a pasta de saída do projeto e é renomeado ApplicationName. exe.config.
Após o <configuration> mas antes de marcar o </configuration> marca, adicione o XML apropriado para configurar seus comutadores. Os exemplos a seguir demonstram um BooleanSwitch with a DisplayName propriedade DataMessageSwitch e um TraceSwitch with a DisplayName propriedade TraceLevelSwitch.
<system.diagnostics> <switches> <add name="DataMessagesSwitch" value="0" /> <add name="TraceLevelSwitch" value="0" /> </switches> </system.diagnostics>Nessa configuração, ambos os switches estão defasados.
Se você precisar ativar um BooleanSwitch, such sistema autônomo DataMessagesSwitch mostrado no exemplo anterior, alterar o Valor sistema autônomo qualquer inteiro diferente de 0.
Se você precisar ativar um TraceSwitch, such sistema autônomo TraceLevelSwitch mostrado no exemplo anterior, altere o Valor para a configuração do nível adequada (de 1 a 4).
Adicione comentários ao arquivo .config para que o usuário participante tenha um entendimento claro do que valores para alterar para configurar adequadamente os switches.
O exemplo a seguir mostra como o código final, incluindo comentários, deverá ficar:
<system.diagnostics> <switches> <!-- This switch controls data messages. In order to receive data trace messages, change value="0" to value="1" --> <add name="DataMessagesSwitch" value="0" /> <!-- This switch controls general messages. In order to receive general trace messages change the value to the appropriate level. "1" gives error messages, "2" gives errors and warnings, "3" gives more detailed error information, and "4" gives verbose trace information --> <add name="TraceLevelSwitch" value="0" /> </switches> </system.diagnostics>
Consulte também
Tarefas
Como: Adicionar instruções de rastreamento ao código do aplicativo
Conceitos
Introdução à instrumentação e rastreamento
Referência
Rastreamento e esquema configurações Debug