TraceContextEventArgs.TraceRecords Propriedade

Definição

Obtém uma coleção de mensagens TraceContextRecord associadas à solicitação atual.Gets a collection of TraceContextRecord messages that are associated with the current request.

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 da propriedade

ICollection

Uma coleção de registros de rastreamento que estão associados à solicitação atual.A collection of trace records that are associated with the current request.

Exemplos

O exemplo de código a seguir demonstra como você pode registrar um TraceContextEventHandler delegado para manipular o TraceFinished evento.The following code example demonstrates how you can register a TraceContextEventHandler delegate to handle the TraceFinished event. Neste exemplo, o OnTraceFinished método acessa a coleção de TraceContextRecord objetos por meio da TraceRecords propriedade, itera através deles e os grava no fluxo de resposta.In this example, the OnTraceFinished method accesses the collection of TraceContextRecord objects through the TraceRecords property, iterates through them, and writes them to the response stream.

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

Comentários

Cada chamada para os TraceContext.Write TraceContext.Warn métodos e gera um TraceContextRecord objeto que é adicionado à TraceRecords coleção de mensagens.Every call to the TraceContext.Write and TraceContext.Warn methods generates a TraceContextRecord object that is added to the TraceRecords messages collection. A Warn chamada de método define a IsWarning propriedade como true , enquanto as outras chamadas de método as definem como false .The Warn method call sets the IsWarning property to true, while the other method calls set it to false.

Você pode iterar pelas TraceRecords mensagens e examinar os registros com categorias ou mensagens específicas e se eles são avisos.You can iterate through the TraceRecords messages and examine records with specific categories or messages, and whether they are warnings.

Aplica-se a

Confira também