WebPageTraceListener Classe
Definição
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
Exemplos
O exemplo de código a seguir demonstra como rotear Trace mensagens para saída de formulário da Web.The following code example demonstrates how to route Trace messages to Web form output. O exemplo de código mostra um formulário da Web típico contendo um BulletedList AccessDataSource controle and.The code example shows a typical Web form containing a BulletedList and AccessDataSource control. O rastreamento é habilitado no formulário da Web e a saída do rastreamento é anexada ao formulário da Web quando ele é renderizado.Tracing is enabled on the Web form and trace output is appended to the Web form when it is rendered. Você pode examinar as mensagens de rastreamento na tabela informações de rastreamento da saída do rastreamento.You can examine the trace messages in the Trace Information table of the trace output. Se você tiver habilitado o WebPageTraceListener corretamente em seu arquivo de configuração, verá as mensagens de rastreamento com a categoria "Trace Test" .If you have enabled the WebPageTraceListener correctly in your configuration file, you see both trace messages with the category "Trace Test". No entanto, se você não tiver habilitado o WebPageTraceListener , verá apenas a mensagem de rastreamento que é gravada no TraceContext objeto.However, if you have not enabled the WebPageTraceListener, you see only the trace message that is written to the TraceContext object.
<%@ 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 .The HostProtectionAttribute attribute applied to this class has the following Resources property value: Synchronization. HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador).The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). Para obter mais informações, consulte a HostProtectionAttribute classe ou os atributos de proteção de host e de programação de SQL Server.For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.
A WebPageTraceListener classe encaminha as mensagens de rastreamento que são gravadas no Trace log para os canais de saída de página da Web do ASP.net.The WebPageTraceListener class forwards trace messages that are written to the Trace log to ASP.NET Web page output channels. Você pode habilitar o encaminhamento de rastreamento adicionando um WebPageTraceListener objeto ao arquivo de Web.config como um ouvinte na subseção do elemento de rastreamento (esquema de configurações do ASP.net) da seção < System. > Diagnostics .You can enable trace forwarding by adding a WebPageTraceListener object to your Web.config file as a listener in the trace Element (ASP.NET Settings Schema) subsection of the <system.diagnostics> section. Você também pode adicionar um WebPageTraceListener à coleção Listeners programaticamente.You can also add a WebPageTraceListener to the listeners collection programmatically. Normalmente, isso é feito adicionando um WebPageTraceListener à coleção durante a inicialização do aplicativo, usando o Application_Start método no arquivo global. asax.Commonly, this is done by adding a WebPageTraceListener to the collection during application startup, using the Application_Start method in the Global.asax file.
Construtores
| WebPageTraceListener() |
Inicializa uma nova instância da classe WebPageTraceListener.Initializes a new instance of the WebPageTraceListener class. |
Propriedades
| Attributes |
Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo.Gets the custom trace listener attributes defined in the application configuration file. (Herdado de TraceListener) |
| Filter |
Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento.Gets or sets the trace filter for the trace listener. (Herdado de TraceListener) |
| IndentLevel |
Obtém ou define o nível de recuo.Gets or sets the indent level. (Herdado de TraceListener) |
| IndentSize |
Obtém ou define o número de espaços em um recuo.Gets or sets the number of spaces in an indent. (Herdado de TraceListener) |
| IsThreadSafe |
Obtém um valor que indica se o ouvinte de rastreamento é thread-safe.Gets a value indicating whether the trace listener is thread safe. (Herdado de TraceListener) |
| Name |
Obtém ou define um nome para este TraceListener.Gets or sets a name for this TraceListener. (Herdado de TraceListener) |
| NeedIndent |
Obtém ou define um valor que indica se a saída deve ser recuada.Gets or sets a value indicating whether to indent the output. (Herdado de TraceListener) |
| TraceOutputOptions |
Obtém ou define as opções de saída de rastreamento.Gets or sets the trace output options. (Herdado de TraceListener) |
Métodos
| Close() |
Quando substituído em uma classe derivada, fecha o fluxo de saída para que ele não receba mais saídas de rastreamento ou depuração.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output. (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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados pelo TraceListener.Releases all resources used by the TraceListener. (Herdado de TraceListener) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo TraceListener e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources. (Herdado de TraceListener) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte criado ao implementar a classe TraceListener.Emits an error message to the listener you create when you implement the TraceListener class. (Herdado de TraceListener) |
| Fail(String, String) |
Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte criado ao implementar a classe TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class. (Herdado de TraceListener) |
| Flush() |
Quando substituído em uma classe derivada, libera o buffer de saída.When overridden in a derived class, flushes the output buffer. (Herdado de TraceListener) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados com suporte no ouvinte de rastreamento.Gets the custom attributes supported by the trace listener. (Herdado de TraceListener) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (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 para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object. (Herdado de MarshalByRefObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Grava as informações de rastreamento, um objeto de dados e informações de evento para a saída específica do ouvinte.Writes trace information, a data object and event information to the listener specific output. (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 na saída específica do ouvinte.Writes trace information, an array of data objects and event information to the listener specific output. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Grava as informações de rastreamento e evento para a saída específica do ouvinte.Writes trace and event information to the listener specific output. (Herdado de TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Grava uma mensagem de evento em uma página da Web ou no visualizador de rastreamento do ASP.NET usando o sistema e os dados de evento especificados.Writes an event message to a Web page or to the ASP.NET trace viewer using the specified system and event data. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Grava uma mensagem de evento traduzida em uma página da Web ou no visualizador de rastreamento do ASP.NET usando o sistema e os dados de evento especificados.Writes a localized event message to a Web page or to the ASP.NET trace viewer using the specified system and event data. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Grava informações de rastreamento, uma mensagem, uma identidade de atividade relacionada e informações de evento na saída específica do ouvinte.Writes trace information, a message, a related activity identity and event information to the listener specific output. (Herdado de TraceListener) |
| Write(Object) |
Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class. (Herdado de TraceListener) |
| Write(Object, String) |
Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class. (Herdado de TraceListener) |
| Write(String) |
Grava uma mensagem em uma página da Web ou no visualizador de rastreamento do ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer. |
| Write(String, String) |
Grava um nome de categoria e uma mensagem em uma página da Web ou no visualizador de rastreamento do ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer. |
| WriteIndent() |
Grava o recuo para o ouvinte criar durante a implementação dessa classe e redefine a propriedade NeedIndent para |
| WriteLine(Object) |
Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator. (Herdado de TraceListener) |
| WriteLine(Object, String) |
Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator. (Herdado de TraceListener) |
| WriteLine(String) |
Grava uma mensagem em uma página da Web ou no visualizador de rastreamento do ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer. |
| WriteLine(String, String) |
Grava um nome de categoria e uma mensagem em uma página da Web ou no visualizador de rastreamento do ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer. |