Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

WebPageTraceListener (Clase)

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)

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class WebPageTraceListener : TraceListener

El tipo WebPageTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoWebPageTraceListenerInicializa una nueva instancia de la clase WebPageTraceListener.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Se hereda de TraceListener).
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaIndentLevelObtiene o establece el nivel de sangría. (Se hereda de TraceListener).
Propiedad públicaIndentSizeObtiene o establece el número de espacios de una sangría. (Se hereda de TraceListener).
Propiedad públicaIsThreadSafeObtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Se hereda de TraceListener).
Propiedad públicaNameObtiene o establece un nombre para este objeto TraceListener. (Se hereda de TraceListener).
Propiedad protegidaNeedIndentObtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Se hereda de TraceListener).
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Arriba

  NombreDescripción
Método públicoCloseCuando 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. (Se hereda de TraceListener).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por TraceListener. (Se hereda de TraceListener).
Método protegidoDispose(Boolean)Libera los recursos no administrados usados por TraceListener y, opcionalmente, los recursos administrados. (Se hereda de TraceListener).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método públicoFail(String)Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoFail(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. (Se hereda de TraceListener).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFlushCuando se reemplaza en una clase derivada, vacía el búfer de resultados. (Se hereda de TraceListener).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. (Se hereda de TraceListener).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32)Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoTraceEvent(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. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).
Método públicoTraceEvent(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. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).
Método públicoTraceTransferEscribe 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. (Se hereda de TraceListener).
Método públicoWrite(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWrite(String)Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET. (Invalida a TraceListener.Write(String)).
Método públicoWrite(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. (Se hereda de TraceListener).
Método públicoWrite(String, String)Escribe un nombre de categoría y un mensaje en una página Web o en el visor de seguimiento ASP.NET. (Invalida a TraceListener.Write(String, String)).
Método protegidoWriteIndentEscribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false. (Se hereda de TraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(String)Escribe un mensaje en una página Web o en el visor de seguimiento ASP.NET. (Invalida a TraceListener.WriteLine(String)).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(String, String)Escribe un nombre de categoría y un mensaje en una página Web o en el visor de seguimiento ASP.NET. (Invalida a TraceListener.WriteLine(String, String)).
Arriba

NotaNota

El atributo HostProtectionAttribute aplicado a esta clase tiene el valor de la propiedad Resources siguiente: 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 en SQL Server y atributos de protección de 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.

NotaNota

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 en SQL Server y atributos de protección de host.

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. La traza se habilita en el formulario Web Forms y el resultado de traza 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>


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft