WebPageTraceListener Clase

Definición

Proporciona un agente de escucha que dirige los mensajes Trace a resultados de páginas Web ASP.NET.Provides a listener that directs Trace messages to ASP.NET Web page outputs.

public ref class WebPageTraceListener : System::Diagnostics::TraceListener
public class WebPageTraceListener : System.Diagnostics.TraceListener
type WebPageTraceListener = class
    inherit TraceListener
Public Class WebPageTraceListener
Inherits TraceListener
Herencia
WebPageTraceListener

Ejemplos

En el ejemplo de código siguiente se muestra Trace cómo enrutar los mensajes a la salida de formularios Web Forms.The following code example demonstrates how to route Trace messages to Web form output. En el ejemplo de código se muestra un formulario Web BulletedList típico AccessDataSource que contiene un control y.The code example shows a typical Web form containing a BulletedList and AccessDataSource control. El seguimiento está habilitado en el formulario web y el resultado del seguimiento se anexa al formulario web cuando se representa.Tracing is enabled on the Web form and trace output is appended to the Web form when it is rendered. Puede examinar los mensajes de seguimiento en la tabla de información de seguimiento de los resultados del seguimiento.You can examine the trace messages in the Trace Information table of the trace output. Si ha habilitado WebPageTraceListener correctamente en el archivo de configuración, verá ambos mensajes de seguimiento con la categoría "Trace Test".If you have enabled the WebPageTraceListener correctly in your configuration file, you see both trace messages with the category "Trace Test". Sin embargo, si no ha habilitado WebPageTraceListener, solo verá el mensaje de seguimiento que se escribe en el 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>

Comentarios

Nota

El HostProtectionAttribute atributo que se aplica a esta clase tiene Resources el siguiente valor Synchronizationde propiedad:.The HostProtectionAttribute attribute applied to this class has the following Resources property value: Synchronization. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador).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 obtener más información, vea HostProtectionAttribute la clase o SQL Server atributos de protección de host y de programación.For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

La WebPageTraceListener clase reenvía los mensajes de seguimiento que se Trace escriben en el registro a los canales de salida de la Página Web ASP.net.The WebPageTraceListener class forwards trace messages that are written to the Trace log to ASP.NET Web page output channels. Puede habilitar el reenvío de seguimiento agregando WebPageTraceListener un objeto al archivo Web. config como un agente de escucha en la subsección del elemento trace (esquema de configuración de ASP.net) de la <sección 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. También puede Agregar un WebPageTraceListener a la colección Listeners mediante programación.You can also add a WebPageTraceListener to the listeners collection programmatically. Normalmente, esto se hace agregando un WebPageTraceListener a la colección durante el inicio de la aplicación Application_Start , utilizando el método en el archivo 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.

Constructores

WebPageTraceListener()

Inicializa una nueva instancia de la clase WebPageTraceListener.Initializes a new instance of the WebPageTraceListener class.

Propiedades

Attributes

Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación.Gets the custom trace listener attributes defined in the application configuration file.

(Heredado de TraceListener)
Filter

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.Gets or sets the trace filter for the trace listener.

(Heredado de TraceListener)
IndentLevel

Obtiene o establece el nivel de sangría.Gets or sets the indent level.

(Heredado de TraceListener)
IndentSize

Obtiene o establece el número de espacios de una sangría.Gets or sets the number of spaces in an indent.

(Heredado de TraceListener)
IsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.Gets a value indicating whether the trace listener is thread safe.

(Heredado de TraceListener)
Name

Obtiene o establece un nombre para este objeto TraceListener.Gets or sets a name for this TraceListener.

(Heredado de TraceListener)
NeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.Gets or sets a value indicating whether to indent the output.

(Heredado de TraceListener)
TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.Gets or sets the trace output options.

(Heredado de TraceListener)

Métodos

Close()

Cuando se reemplaza en una clase derivada, se cierra el flujo de salida para que ya no reciba resultados de la traza o de la depuración.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

(Heredado de TraceListener)
CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa TraceListener.Releases all resources used by the TraceListener.

(Heredado de TraceListener)
Dispose(Boolean)

Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Heredado de TraceListener)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Fail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Flush()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados.When overridden in a derived class, flushes the output buffer.

(Heredado de TraceListener)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.Gets the custom attributes supported by the trace listener.

(Heredado de TraceListener)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en los resultados específicos del agente de escucha.Writes trace information, a data object and event information to the listener specific output.

(Heredado de TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en los resultados específicos del agente de escucha.Writes trace information, an array of data objects and event information to the listener specific output.

(Heredado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.Writes trace and event information to the listener specific output.

(Heredado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe un mensaje de evento en una página Web o en el visor de seguimiento ASP.NET utilizando el sistema y los datos del 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[])

Escribe un mensaje de evento localizado en una página Web o en el visor de seguimiento ASP.NET utilizando el sistema y los datos del 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)

Escribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Heredado de TraceListener)
Write(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Write(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase 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.

(Heredado de TraceListener)
Write(String)

Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer.

Write(String, String)

Escribe un nombre de categoría y un mensaje en una página Web o en el visor de seguimiento ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer.

WriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Heredado de TraceListener)
WriteLine(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea.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.

(Heredado de TraceListener)
WriteLine(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.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.

(Heredado de TraceListener)
WriteLine(String)

Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer.

WriteLine(String, String)

Escribe un nombre de categoría y un mensaje en una página Web o en el visor de seguimiento ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer.

Se aplica a

Consulte también: