TraceContextEventArgs.TraceRecords Propiedad

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Obtiene una colección de mensajes TraceContextRecord asociados a la solicitud actual.

public:
 property System::Collections::ICollection ^ TraceRecords { System::Collections::ICollection ^ get(); };

public System.Collections.ICollection TraceRecords { get; }

member this.TraceRecords : System.Collections.ICollection

Public ReadOnly Property TraceRecords As ICollection

Valor de propiedad

ICollection

Colección de registros de seguimiento asociados a la solicitud actual.

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

Cada llamada a los TraceContext.Write métodos y TraceContext.Warn genera un TraceContextRecord objeto que se agrega a la TraceRecords colección messages. La Warn llamada al método establece la IsWarning propiedad en true, mientras que las demás llamadas de método la establecen en false.

Puede recorrer en iteración los TraceRecords mensajes y examinar los registros con categorías o mensajes específicos y si son advertencias.

Consulte también

• TraceContextRecord
• TraceContextEventHandler
• TraceContext
• Información general sobre la traza de ASP.NET