Elemento trace (ASP.NET Settings Schema)
[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]
Configura o aplicativo ASP.Serviço de rastreamento de NET de código que controla como os resultados do rastreamento são coletados, armazenados e exibidos.
<trace
enabled="true|false"
localOnly="true|false"
pageOutput="true|false"
requestLimit="integer"
mostRecent="true|false"
writeToDiagnosticsTrace="true|false"
traceMode="SortByTime|SortByCategory"
/>
Attributes and Elements
As seções a seguir descrevem atributos, elementos filho, e elementos pai.
Attributes
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 em 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 de aplicativo mais recente é exibida e os dados antigos de rastreamento além dos limites que são indicados pela requestLimit é descartado. Se false, 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 pode ser acessada 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, rastreamento será desabilitado automaticamente. O limite máximo de solicitação é 10.000. Se for especificado um valor maior que 10.000, ele é silenciosamente arredondado para baixo a 10.000 pelo ASP.NET. O padrão é 10. |
traceMode |
Opcional TraceDisplayMode atributo. Especifica a ordem na qual deseja exibir informações de rastreamento. O traceMode atributo pode ser um dos seguintes valores possíveis.
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 que estão 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. |
Child Elements
Nenhum.
Parent Elements
Elemento |
Descrição |
---|---|
configuration |
O elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.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 que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam. |
Remarks
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, Trace. axd é adicionado para o httpHandlers elemento.
Observação
Em geral, 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 a localOnly atributo é true, as informações de rastreamento são exibidas somente para solicitações 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 cria a classe para a 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 de linguagem que você deseja oferecer suporte a rastreamento. Consulte<compiler> Elemento
Configuração padrão
O seguinte padrão trace elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é 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>
Element Information
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 Directory–level virtuais ou físicas 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
Tasks
How to: View Trace Information with the Trace Viewer
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
System. Web Element (ASP.NET Settings Schema)
configuração Element (General Settings Schema)
Concepts
ASP.NET Configuration File Hierarchy
Other Resources
Configurações gerais (ASP.NET)
ASP.Definições de configuração de rede