WebPageTraceListener Classe

Definição

Espaço de Nomes:: System.Web

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece um ouvinte que direciona mensagens Trace para ASP.NET saídas da página Web.

public ref class WebPageTraceListener : System::Diagnostics::TraceListener

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Herança: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Exemplos

O exemplo de código seguinte demonstra como encaminhar Trace mensagens para a saída do formulário Web. O exemplo de código mostra um formulário Web típico contendo um BulletedList controlo e AccessDataSource . O rastreio está ativado no formulário Web e a saída de rastreio é anexada ao formulário Web quando é renderizado. Pode examinar as mensagens de rastreio na tabela de Informação de Traço da saída do traço. Se tiver ativado corretamente o WebPageTraceListener no seu ficheiro de configuração, verá ambas as mensagens de rastreio com a categoria "Trace Test". No entanto, se não tiver ativado o WebPageTraceListener, vê apenas a mensagem de rastreio que está escrita no TraceContext objeto.

<%@ Page language="C#" trace="true" %>

<script runat="server">
private void page_load(object sender, EventArgs e) {
    
    Trace.Write("Trace Test","This message is written with the TraceContext object.");

    System.Diagnostics.Trace.WriteLine("This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.");
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>

</form>
</body>
</html>

<%@ Page language="VB" trace="true" %>

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
    
    Trace.Write("Trace Test","This message is written with the System.Web.TraceContext object.")

    System.Diagnostics.Trace.Write("Trace Test", "This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.")

End Sub ' Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>
</form>
</body>
</html>

Observações

Note

O HostProtectionAttribute atributo aplicado a esta classe tem o seguinte Resources valor de propriedade: Synchronization. Isto HostProtectionAttribute não afeta aplicações de ambiente de trabalho (que normalmente são iniciadas com duplo clique num ícone, digitação de um comando ou introdução de um URL no navegador). Para mais informações, consulte a classe HostProtectionAttribute ou SQL Server Atributos de Programação e Proteção de Host.

A classe WebPageTraceListener encaminha mensagens de rastreio que são escritas nos canais de saída Trace log para ASP.NET página Web. Pode ativar o encaminhamento de traços adicionando um objeto WebPageTraceListener ao seu ficheiro de Web.config como ouvinte na subseção trace Element (ASP.NET Settings Schema) da secção <system.diagnostics>. Também pode adicionar a WebPageTraceListener à coleção de ouvintes de forma programática. Normalmente, isto é feito adicionando a WebPageTraceListener à coleção durante o arranque da aplicação, usando o Application_Start método no ficheiro Global.asax.

Construtores

Name	Description
WebPageTraceListener()	Inicializa uma nova instância da WebPageTraceListener classe.

Propriedades

Name	Description
Attributes	Obtém os atributos personalizados do ouvinte de rastreio definidos no ficheiro de configuração da aplicação. (Herdado de TraceListener)
Filter	Obtém ou define o filtro de traço para o ouvinte de traços. (Herdado de TraceListener)
IndentLevel	Obtém ou define o nível da recuação. (Herdado de TraceListener)
IndentSize	Obtém ou define o número de espaços num reentro. (Herdado de TraceListener)
IsThreadSafe	Recebe um valor que indica se o ouvinte de rastreio é seguro para threads. (Herdado de TraceListener)
Name	Obtém ou define um nome para este TraceListener. (Herdado de TraceListener)
NeedIndent	Obtém ou define um valor que indica se deve indentar a saída. (Herdado de TraceListener)
TraceOutputOptions	Obtém ou define as opções de saída do traço. (Herdado de TraceListener)

Métodos

Name	Description
Close()	Quando é sobreposto numa classe derivada, fecha o fluxo de saída para que já não receba saída de traçado ou depuração. (Herdado de TraceListener)
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Liberta todos os recursos utilizados pelo TraceListener. (Herdado de TraceListener)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo TraceListener e opcionalmente liberta os recursos geridos. (Herdado de TraceListener)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Fail(String, String)	Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener)
Fail(String)	Emite uma mensagem de erro para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener)
Flush()	Quando sobreposto numa classe derivada, limpa o buffer de saída. (Herdado de TraceListener)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetSupportedAttributes()	Obtém os atributos personalizados suportados pelo ouvinte de rastreamento. (Herdado de TraceListener)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Escreve informação de traço, um objeto de dados e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Escreve informação de rastreio, um array de objetos de dados e informação de eventos para a saída específica do ouvinte. (Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Escreve uma mensagem de evento localizada numa página Web ou no visualizador de rastreios ASP.NET usando os dados do sistema e do evento especificados.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Escreve uma mensagem de evento numa página Web ou no visualizador de rastreios ASP.NET usando os dados do sistema e do evento especificados.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Escreve informações de rastreio e evento para a saída específica do ouvinte. (Herdado de TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Escreve informação de rastreio, uma mensagem, uma identidade de atividade relacionada e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener)
Write(Object, String)	Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener)
Write(Object)	Escreve o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener)
Write(String, String)	Escreve um nome de categoria e uma mensagem numa página Web ou no visualizador de rastreamento ASP.NET.
Write(String)	Escreve uma mensagem numa página Web ou no visualizador de rastreamento ASP.NET.
WriteIndent()	Escreve o indentamento para o ouvinte que crias quando implementas esta classe, e redefine a NeedIndent propriedade para `false`. (Herdado de TraceListener)
WriteLine(Object, String)	Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener)
WriteLine(Object)	Escreve o valor do método do ToString() objeto para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener)
WriteLine(String, String)	Escreve um nome de categoria e uma mensagem numa página Web ou no visualizador de rastreamento ASP.NET.
WriteLine(String)	Escreve uma mensagem numa página Web ou no visualizador de rastreamento ASP.NET.

Aplica-se a

Ver também

ASP.NET Visão Geral do Rastreio

Comentários

Esta página foi útil?