TraceContextRecord Clase

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Representa un mensaje de seguimiento de ASP.NET y sus datos asociados.

public ref class TraceContextRecord sealed

public sealed class TraceContextRecord

type TraceContextRecord = class

Public NotInheritable Class TraceContextRecord

Herencia

Object

TraceContextRecord

Ejemplos

En el ejemplo de código siguiente se muestra cómo puede registrar un TraceContextEventHandler delegado para controlar el TraceFinished evento. En este ejemplo, el OnTraceFinished método obtiene acceso a la colección de objetos a través de TraceContextRecord la TraceRecords propiedad , itera a través de ellos y los escribe en el flujo de respuesta.

<%@ Page language="c#" Trace="true" %>
<script runat="server">
void Page_Load(object sender, EventArgs e)
{
    // Register a handler for the TraceFinished event.
    Trace.TraceFinished += new 
        TraceContextEventHandler(this.OnTraceFinished);

    // Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.");
}
 
// A TraceContextEventHandler for the TraceFinished event.
void OnTraceFinished(object sender, TraceContextEventArgs e)
{
    TraceContextRecord r = null;    
    
    // Iterate through the collection of trace records and write 
    // them to the response stream.
    foreach(object o in e.TraceRecords)
    {
        r = (TraceContextRecord)o;
        Response.Write(String.Format("trace message: {0} <BR>", r.Message));
    }
}       
</script>

<%@ Page language="VB" Trace="true" %>
<script runat="server">
' The Page_Load method.
Private Sub Page_Load(sender As Object, e As EventArgs)

    ' Register a handler for the TraceFinished event.
    AddHandler Trace.TraceFinished, AddressOf OnTraceFinished

    ' Write a trace message.
    Trace.Write("Web Forms Infrastructure Methods", "USERMESSAGE: Page_Load complete.")
End Sub ' Page_Load
 
' A TraceContextEventHandler for the TraceFinished event.
Private Sub OnTraceFinished(sender As Object, e As TraceContextEventArgs)

    Dim r As TraceContextRecord
    Dim o As Object
    
    ' Iterate through the collection of trace records and write 
    ' them to the response stream.

    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
        Response.Write(String.Format("trace message: {0} <BR>", r.Message))
    Next

End Sub ' OnTraceFinished
</script>

Comentarios

El TraceContextRecord objeto encapsula el mensaje de seguimiento, la categoría, cualquier asociado Exceptiony si el método escribió el registro de TraceContext.Warn seguimiento.

Cada llamada a los TraceContext.Write métodos y TraceContext.Warn genera un TraceContextRecord objeto que se agrega a la TraceContextEventArgs.TraceRecords colección messages. Puede acceder a la colección de registros controlando el TraceFinished evento .

Constructores

TraceContextRecord(String, String, Boolean, Exception)

Inicializa una nueva instancia de la clase TraceContextRecord.

Propiedades

Category	Obtiene la categoría definida por el usuario para el registro de seguimiento.
ErrorInfo	Obtiene la Exception asociada al registro de seguimiento, si la hay.
IsWarning	Obtiene un valor que indica si el registro de seguimiento está asociado a una llamada al método Warn.
Message	Obtiene el mensaje de seguimiento definido por el usuario.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• TraceContextEventArgs
• TraceContextEventHandler
• Información general sobre la traza de ASP.NET
• Cómo: habilitar el seguimiento de una página de ASP.NET