trace Element (ASP.NET Settings Schema)
Configura o ASP.O serviço de rastreamento do NET de código que controla como os resultados do rastreamento são reunidos, armazenados e exibidos.
<trace
enabled="true|false"
localOnly="true|false"
pageOutput="true|false"
requestLimit="integer"
mostRecent="true|false"
writeToDiagnosticsTrace="true|false"
traceMode="SortByTime|SortByCategory"
/>
Atributos e elementos
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Atributos
Atributo |
Descrição |
|---|---|
enabled |
Opcional Boolean atributo. Especifica se o rastreamento está habilitado para um aplicativo. O rastreamento deve ser habilitado para usar o visualizador Trace. axd. Por padrão, o visualizador Trace. axd é adicionado para o httpHandlers elemento. O padrão é false. |
localOnly |
Opcional Boolean atributo. Especifica se o Visualizador de rastreamento (Trace. axd) está disponível somente no servidor Web host. Se false, o Visualizador de rastreamento está disponível a partir de qualquer computador. Por padrão, o visualizador Trace. axd é adicionado para o httpHandlers elemento. O padrão é true. |
mostRecent |
Opcional Boolean atributo. Especifica se a saída de rastreamento em nível de aplicativo mais recente é exibida e os dados antigos de rastreamento além dos limites que são indicados pela requestLimit é descartado. Se false, os dados de rastreamento são exibidos para solicitações até que o requestLimit atributo for atingido. Esse atributo é novo na.NET Framework versão 2.0. O padrão é false. |
pageOutput |
Opcional Boolean atributo. Especifica se a saída de rastreamento é processada no final de cada página. Se false, a saída de rastreamento é acessível através do utilitário de rastreamento somente. O padrão é false. |
requestLimit |
Opcional Int32 atributo. Especifica o número de solicitações de rastreamento para armazenar no servidor. Se o limite for atingido e a mostRecent atributo é false, o rastreamento é desativado automaticamente. O limite máximo de solicitação é 10.000. Se um valor maior que 10.000 for especificado, ele será silenciosamente arredondado para 10.000 pelo ASP.NET. O padrão é 10. |
traceMode |
Opcional TraceDisplayMode atributo. Especifica a ordem na qual exibir as informações de rastreamento. O traceMode atributo pode ser uma das seguintes possíveis valores.
ValorDescrição
SortByCategory Especifica que as informações de rastreamento são exibidas em ordem alfabética por categoria definida pelo usuário.
SortByTime Especifica que as informações de rastreamento são exibidas na ordem em que as informações de rastreamento são processadas.
O padrão é SortByTime. |
writeToDiagnosticsTrace |
Opcional Boolean atributo. Especifica se ASP.NET Trace mensagens são encaminhadas para o System.Diagnostics a infra-estrutura de rastreamento, para todos os ouvintes registrados para exibir Trace mensagens. Para obter mais informações, consulte o rastreamento elemento do System. Diagnostics. Esse atributo é novo na.NET Framework versão 2.0. O valor padrão é false. |
Elementos filho
Nenhum.
Elementos pai
Elemento |
Descrição |
|---|---|
configuration |
O elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework. |
system.web |
Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos de configuração para configurar aplicativos ASP.NET e controlar como os aplicativos se comportam. |
Comentários
Quando o rastreamento estiver ativado, cada solicitação de página gera mensagens de rastreamento que podem ser acrescentadas à saída de página ou armazenadas em um log de rastreamento do aplicativo. Você pode usar o ASP.NET trace. axd () para exibir o conteúdo do log de rastreamento. Por padrão, o Trace. axd é adicionado para o httpHandlers elemento.
Observação
Geralmente, você não deve ativar o rastreamento em um site ativo, pois isso pode exibir informações confidenciais de configuração a todos que exibirem as páginas no site da Web.O rastreamento é destinado somente para fins de depuração.Se o localOnly atributo é true, informações de rastreamento são exibidas somente para solicitações de localhost.Além disso, se <deployment retail=true> é definido no arquivo Web. config, o rastreamento está desabilitado.
Você pode usar as propriedades e métodos do Trace classe para compilações de versão de instrumento. Instrumentação permite monitorar a integridade de seu aplicativo executando o aplicativo na vida real. Rastreamento ajuda a isolar problemas e corrigir os problemas sem interromper um sistema em execução.
Para o rastreamento entrem em vigor, você precisa recompilar seu aplicativo com o sinalizador de rastreamento definido. Fazer isso, definindo a compilerOptions atributo para = "/ d:TRACE" na linha de configuração para o compilador da linguagem que você deseja oferecer suporte a rastreamento. Consulte<compiler> Elemento
Configuração padrão
O seguinte padrão trace é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é a configuração padrão que é retornada pelo aplicativo na.NET Framework 2.0 e versões posteriores.
<trace
enabled="false"
localOnly="true"
mostRecent="false"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
writeToDiagnosticsTrace="false"
/>
O seguinte padrão trace elemento é configurado no arquivo Machine. config na.NET Framework versões 1.0 e 1.1.
<trace
enabled="false"
localOnly="true"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
/>
Exemplo
O exemplo de código a seguir demonstra como especificar configurações de rastreamento.
<configuration>
<system.web>
<trace enabled="true"
pageOutput="true"
requestLimit="15"
mostRecent="true" />
<system.web>
</configuration>
Informações do elemento
Manipulador da seção de configuração |
|
Membro de configuração |
|
Locais configuráveis |
Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Virtual ou física directory–level Web. config |
Requisitos |
Versão de Serviços de Informações da Internet da Microsoft (IIS) 5.0 ou posterior O .NET Framework Microsoft Visual Studio |
Consulte também
Tarefas
Como: exibir informações de rastreamento ASP.NET com o Visualizador de Rastreamento (Trace Viewer)
Como: Configurar Diretórios Específicos Usando Configurações por Localização
Como: Bloquear definições de configuração ASP.NET
Referência
system.web Element (ASP.NET Settings Schema)
configuração Element (Geral Configurações Schema)
Conceitos
Visão geral do rastreamento no ASP.NET
Hierarquia e Herança do Arquivo de Configuração do ASP.NET
Protegendo a configuração do ASP.NET
Cenários de configuração ASP.NET
Outros recursos
General Configuration Settings (ASP.NET)
ASP.NET Configuration Settings