WebPageTraceListener Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece um ouvinte que direciona mensagens para saídas Trace de página da Web ASP.NET.
public ref class WebPageTraceListener : System::Diagnostics::TraceListenerpublic class WebPageTraceListener : System.Diagnostics.TraceListenertype WebPageTraceListener = class
inherit TraceListenerPublic Class WebPageTraceListener
Inherits TraceListener- Herança
Exemplos
O exemplo de código a seguir demonstra como rotear Trace mensagens para a saída do formulário da Web. O exemplo de código mostra um formulário da Web típico que contém um controle e AccessDataSource umBulletedList. O rastreamento está habilitado no formulário da Web e a saída de rastreamento é acrescentada ao formulário da Web quando ele é renderizado. Você pode examinar as mensagens de rastreamento na tabela Informações de Rastreamento da saída do rastreamento. Se você tiver habilitado o WebPageTraceListener arquivo de configuração corretamente, verá ambas as mensagens de rastreamento com a categoria "Trace Test". No entanto, se você não tiver habilitado o WebPageTraceListener, verá apenas a mensagem de rastreamento que é gravada 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>
Comentários
Observação
O HostProtectionAttribute atributo aplicado a essa classe tem o seguinte Resources valor de propriedade: Synchronization. Isso HostProtectionAttribute não afeta aplicativos da área de trabalho (que normalmente são iniciados clicando duas vezes em um ícone, digitando um comando ou inserindo uma URL em um navegador). Para obter mais informações, consulte a HostProtectionAttribute classe ou os atributos de programação e proteção de host do SQL Server.
A WebPageTraceListener classe encaminha mensagens de rastreamento que são gravadas no Trace log para ASP.NET canais de saída da página da Web. Você pode habilitar o encaminhamento de rastreamento adicionando um WebPageTraceListener objeto ao arquivo Web.config como ouvinte na subseção elemento de rastreamento (esquema de configurações de ASP.NET) da <seção system.diagnostics> . Você também pode adicionar um WebPageTraceListener à coleção de ouvintes programaticamente. Normalmente, isso é feito adicionando uma WebPageTraceListener coleção durante a inicialização do aplicativo, usando o Application_Start método no arquivo Global.asax.
Construtores
| Nome | Description |
|---|---|
| WebPageTraceListener() |
Inicializa uma nova instância da classe WebPageTraceListener. |
Propriedades
| Nome | Description |
|---|---|
| Attributes |
Obtém os atributos do ouvinte de rastreamento personalizado definidos no arquivo de configuração do aplicativo. (Herdado de TraceListener) |
| Filter |
Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento. (Herdado de TraceListener) |
| IndentLevel |
Obtém ou define o nível de recuo. (Herdado de TraceListener) |
| IndentSize |
Obtém ou define o número de espaços em um recuo. (Herdado de TraceListener) |
| IsThreadSafe |
Obtém um valor que indica se o ouvinte de rastreamento é thread-safe. (Herdado de TraceListener) |
| Name |
Obtém ou define um nome para isso TraceListener. (Herdado de TraceListener) |
| NeedIndent |
Obtém ou define um valor que indica se deve recuar a saída. (Herdado de TraceListener) |
| TraceOutputOptions |
Obtém ou define as opções de saída de rastreamento. (Herdado de TraceListener) |
Métodos
| Nome | Description |
|---|---|
| Close() |
Quando substituído em uma classe derivada, fecha o fluxo de saída para que ele não receba mais a saída de rastreamento ou depuração. (Herdado de TraceListener) |
| CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados pelo TraceListener. (Herdado de TraceListener) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo TraceListener e, opcionalmente, libera os recursos gerenciados. (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 você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Flush() |
Quando substituído em uma classe derivada, libera o buffer de saída. (Herdado de TraceListener) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados compatíveis com o ouvinte de rastreamento. (Herdado de TraceListener) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Grava informações de rastreamento, um objeto de dados e informações de evento na saída específica do ouvinte. (Herdado de TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Grava informações de rastreamento, uma matriz de objetos de dados e informações de evento para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Grava uma mensagem de evento localizada em uma página da Web ou no visualizador de rastreamento ASP.NET usando os dados de evento e sistema especificados. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Grava uma mensagem de evento em uma página da Web ou no visualizador de rastreamento ASP.NET usando os dados de evento e sistema especificados. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Grava informações de rastreamento e evento na saída específica do ouvinte. (Herdado de TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Grava informações de rastreamento, uma mensagem, uma identidade de atividade relacionada e informações de evento para a saída específica do ouvinte. (Herdado de TraceListener) |
| Write(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(String, String) |
Grava um nome de categoria e uma mensagem em uma página da Web ou no visualizador de rastreamento ASP.NET. |
| Write(String) |
Grava uma mensagem em uma página da Web ou no visualizador de rastreamento ASP.NET. |
| WriteIndent() |
Grava o recuo no ouvinte que você cria ao implementar essa classe e redefine a NeedIndent propriedade para |
| WriteLine(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String, String) |
Grava um nome de categoria e uma mensagem em uma página da Web ou no visualizador de rastreamento ASP.NET. |
| WriteLine(String) |
Grava uma mensagem em uma página da Web ou no visualizador de rastreamento ASP.NET. |
