WebPageTraceListener Clase

Referencia

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona un agente de escucha que dirige los mensajes Trace a resultados de páginas Web ASP.NET.

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

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Herencia: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Ejemplos

En el ejemplo de código siguiente se muestra cómo enrutar Trace los mensajes a la salida del formulario web. En el ejemplo de código se muestra un formulario web típico que contiene un BulletedList control y AccessDataSource . El seguimiento está habilitado en el formulario web y la salida de seguimiento se anexa al formulario web cuando se representa. Puede examinar los mensajes de seguimiento en la tabla Información de seguimiento de la salida de seguimiento. Si ha habilitado correctamente en el WebPageTraceListener archivo de configuración, verá ambos mensajes de seguimiento con la categoría "Trace Test". Sin embargo, si no ha habilitado , WebPageTraceListenersolo verá el mensaje de seguimiento que se escribe en el 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>

Comentarios

Nota

El HostProtectionAttribute atributo aplicado a esta clase tiene el siguiente Resources valor de propiedad: 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). Para obtener más información, vea la HostProtectionAttribute clase o los atributos de programación y protección de host de SQL Server.

La WebPageTraceListener clase reenvía los mensajes de seguimiento escritos en el Trace registro a ASP.NET canales de salida de página web. Puede habilitar el reenvío de seguimiento agregando un WebPageTraceListener objeto al archivo Web.config como agente de escucha en la subsección Elemento de seguimiento (esquema de configuración de ASP.NET) de la <sección system.diagnostics> . También puede agregar un WebPageTraceListener objeto a la colección de agentes de escucha mediante programación. Normalmente, esto se hace agregando a WebPageTraceListener la colección durante el inicio de la aplicación, mediante el Application_Start método en el archivo Global.asax.

Constructores

WebPageTraceListener()

Inicializa una nueva instancia de la clase WebPageTraceListener.

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. (Heredado de TraceListener)
Filter	Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento. (Heredado de TraceListener)
IndentLevel	Obtiene o establece el nivel de sangría. (Heredado de TraceListener)
IndentSize	Obtiene o establece el número de espacios de una sangría. (Heredado de TraceListener)
IsThreadSafe	Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Heredado de TraceListener)
Name	Obtiene o establece un nombre para este objeto TraceListener. (Heredado de TraceListener)
NeedIndent	Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Heredado de TraceListener)
TraceOutputOptions	Obtiene o establece las opciones de los resultados de seguimiento. (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. (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. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa TraceListener. (Heredado de TraceListener)
Dispose(Boolean)	Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados. (Heredado de TraceListener)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Fail(String)	Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (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. (Heredado de TraceListener)
Flush()	Cuando se reemplaza en una clase derivada, vacía el búfer de resultados. (Heredado de TraceListener)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetSupportedAttributes()	Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. (Heredado de TraceListener)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ToString()	Devuelve una cadena que representa el objeto actual. (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. (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. (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. (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.
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.
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. (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. (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. (Heredado de TraceListener)
Write(String)	Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET.
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.
WriteIndent()	Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en `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. (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. (Heredado de TraceListener)
WriteLine(String)	Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET.
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.

Se aplica a

Consulte también

Información general sobre la traza de ASP.NET

Compartir vía