Esta documentación está archivada y no tiene mantenimiento.

WebPageTraceListener (Clase)

Actualización: noviembre 2007

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

Espacio de nombres:  System.Web
Ensamblado:  System.Web (en System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class WebPageTraceListener : TraceListener
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class WebPageTraceListener extends TraceListener
public class WebPageTraceListener extends TraceListener

040095wf.alert_note(es-es,VS.90).gifNota:

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: 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 clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

040095wf.alert_note(es-es,VS.90).gifNota:

El atributo HostProtectionAttribute aplicado a esta clase tiene el valor de propiedad Resources siguiente: Synchronization. HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician al hacer doble clic en un icono, escribir un comando o escribir una dirección URL en un explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación de SQL Server y atributos de protección del host.

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

El ejemplo de código siguiente muestra cómo enrutar los mensajes Trace a los resultados de formularios Web Forms. El ejemplo de código muestra un formulario Web Forms típico que contiene un control BulletedList y AccessDataSource. El seguimiento se habilita en el formulario Web Forms y el resultado de seguimiento se anexa al formulario Web Forms al representarlo. Puede leer los mensajes de seguimiento en la tabla Información de seguimiento de los resultados de seguimiento. Si ha habilitado WebPageTraceListener correctamente en el archivo de configuración, aparecerán los dos mensajes de seguimiento con la categoría "Trace Test". Sin embargo, si no ha habilitado WebPageTraceListener, sólo aparecerá el mensaje de seguimiento escrito en el objeto TraceContext.

<%@ 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>


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: