Rastrear elemento (esquema configurações ASP.NET)
Configura o serviço de rastreamento de código do ASP.NET que controla como os resultados do rastreamento são reunidos, armazenados e exibidos.
configuração elemento (Geral Settings esquema)
System.Web elemento (esquema configurações ASP.NET)
Rastrear elemento (esquema configurações ASP.NET)
<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 ativado para usar o visualizador Trace.axd. Por padrão, o visualizador Trace.axd é adicionado à 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. If false, o Visualizador de rastreamento está disponível em qualquer computador. Por padrão, o visualizador Trace.axd é adicionado à httpHandlers elemento. O padrão é true. |
mostRecent |
Opcional Boolean atributo. Especifica se a saída de rastreamento em nível de aplicativo mais recente será exibida e dados antigos de rastreamento além dos limites são indicados pelo requestLimit é descartado. If false, dados de rastreamento são exibidos para solicitações até que o requestLimit atributo for atingido. Esse atributo é novo no .NET estrutura versão 2.0. O padrão é false. |
pageOutput |
Opcional Boolean atributo. Especifica se a saída do rastreamento é processada no participante de cada página. If false, a saída de rastreamento é acessível por meio de apenas o utilitário de rastreamento. 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 o atributo é false, rastreamento é desabilitado automaticamente. O limite máximo solicitação é 10.000. Se um valor maior que 10.000 for especificado, ele será silenciosamente arredondado para baixo até 10.000 pelo ASP.NET. O padrão é 10. |
traceMode |
Opcional TraceDisplayMode atributo. Especifica a ordem na qual exibir as informações de rastreamento. The traceMode atributo pode ser um dos seguintes valores possíveis.
Valor Descriçã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 mensagens de rastreamento ASP.NET são encaminhadas à System.Diagnostics infra-estrutura de rastreamento, para os ouvintes registrados para exibir Trace mensagens. Para obter mais informações, consulte o rastreamento elemento sistema.Diagnóstico. Esse atributo é novo no .NET estrutura versão 2.0. O valor padrão é false. |
Elementos filho
Nenhum.
Elementos pai
Elemento |
Descrição |
|---|---|
configuration |
O elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura. |
system.web |
Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam. |
Comentários
The trace elemento configura o serviço de rastreamento de código do ASP.NET que controla como os resultados do rastreamento são reunidos, armazenados e exibidos.
Quando o rastreamento estiver ativado, cada solicitação de página gera mensagens de rastreamento que podem ser acrescentadas à saída da página ou armazenadas em um log de rastreamento de aplicativo. Você pode usar o Visualizador de rastreamento do ASP.NET (Trace.axd) para exibir o Sumário do log de rastreamento. Por padrão, Trace.axd é adicionado à httpHandlers elemento.
.gif "Observação") Observação: |
|---|
Em geral, você não deve ativar o rastreamento em um site ativo, pois isso pode exibir informações de configuração confidenciais a todos que exibirem páginas no site da Web. O rastreamento é destinado somente para fins de depuração. Se a localOnly o atributo é true, as informações do rastreamento são exibidas somente para solicitações localhost. Além disso, se <deployment retail=true>é conjunto no arquivo Web.config, o rastreamento está desabilitado. |
Você pode usar as propriedades e métodos no Trace classe instrumentar versão se baseia. Instrumentação permite que você monitore a integridade do seu aplicativo executando o aplicativo nas configurações reais. Você rastreamento ajuda a isolar problemas e corrige os problemas sem interromper um sistema em execução.
Para o rastreamento entrem em vigor, você precisa recompilar seu aplicativo com o sinalizar de rastreamento definido. Você fazer isso, definindo o compilerOptionsatributo para = "/ d:TRACE" na linha de configuração para o compilador da linguagem para oferecer suporte a rastreamento. Consulte < compilador > Elemento
Configuração padrão
O seguinte padrão trace elemento não está configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. No entanto, é a configuração padrão que é retornada pelo aplicativo do .NET estrutura 2.0.
<trace
enabled="false"
localOnly="true"
mostRecent="false"
pageOutput="false"
requestLimit="10"
traceMode="SortByTime"
writeToDiagnosticsTrace="false"
/>
O seguinte padrão element elemento é configurado no arquivo computador.config no .NET estrutura 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 de seção de configuração |
|
Configuração de membro |
|
Locais configuráveis |
Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config |
Requisitos |
Serviços de Informações da Internet da Microsoft (IIS) 5.0, 5.1 ou 6.0 O .NET estrutura versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005 |
Consulte também
Tarefas
Como: Exibir informações de Rastrear ASP.NET com o visualizador de Rastrear
Como: Configurar diretórios específicos usando configurações de local
Como: Bloquear ASP.NET Configuration Settings
Conceitos
Visão geral do rastreamento no ASP.NET
Hierarquia e Herança do Arquivo de Configuração do ASP.NET
Protegendo configuração ASP.NET
Cenários de configuração ASP.NET
Referência
System.Web elemento (esquema configurações ASP.NET)
configuração elemento (Geral Settings esquema)
Outros recursos
Configurações gerais (ASP.NET)
Definições de configuração ASP.NET