Compartilhar via


Como: Habilitar o rastreamento para uma página ASP.NET

Você pode controlar se o rastreamento está ativado ou desativado para páginas individuais.Se o rastreamento está ativado, quando a página for solicitada, ASP.NET acrescentará à página uma série de tabelas contendo detalhes de execução sobre a solicitação de página.O rastreamento é desativado por padrão.

Para habilitar o rastreamento para uma página

  1. Inclua uma diretiva @ Page na parte superior do seu arquivo .aspx.

  2. Adicione um atributo Trace e defina seu valor para true, conforme mostrado no exemplo o seguir:

    <%@ Page Trace="true" %>
    
    Observação de segurança:

    Quando o rastreamento está habilitado para uma página, as informações do rastreamento são exibidas em qualquer navegador que solicite que página.O rastreamento exibe informações sigilosas, como os valores das variáveis do servidor, e pode, portanto, representar uma ameaça à segurança.Não se esqueça desativar o rastreamento de página antes de portar seu aplicativo para um servidor de produção.Você pode fazer isso definindo o atributo Trace para false ou removendo-o.Você também pode configurar o rastreamento no arquivo web.config, definindo os atributos enabled, localOnly e pageOutput do Rastrear elemento (esquema configurações ASP.NET).O atributo Trace na diretiva @ Page tem precedência sobre atributos definidos no elemento TRACE no arquivo web.config.Portanto, mesmo que você desative o rastreamento no arquivo web.config definindo o atributo enabled para false, a página pode ainda mostrar as informações de rastreamento se o atributo Trace na sua diretiva @ Page for definido como true.

  3. Opcionalmente, inclua o atributo TraceMode para especificar a ordem em que você deseja que suas mensagens de rastreamento apareçam:

    • Defina TraceMode para SortByTime para classificar mensagens de rastreamento na ordem em que eles são processados.

    • Defina TraceMode para SortByCategory para classificar mensagens de rastreamento pelas categorias que você especificou nas chamadas de método TraceContext.Warn e TraceContext.Write em sua página ou código de controle de servidor.

    O exemplo a seguir mostra como ativar o rastreamento em uma página e classificar mensagens de rastreamento por categoria.

    <%@ Page Language="VB" Trace="True" TraceMode="SortByCategory" %>
    

Consulte também

Tarefas

Como: Habilitar o rastreamento para um aplicativo ASP.NET

Referência

@ Page

TraceContext

Outros recursos

Rastreamento no ASP.NET

Gravando Mensagens de Rastreamento do ASP.NET Personalizadas

Lendo Informações de Rastreamento do ASP.NET