TraceContextEventArgs.TraceRecords Propriété

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Obtient une collection de messages TraceContextRecord associés à la demande en cours.

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

Valeur de propriété

ICollection

Collection des enregistrements de trace associés à la demande en cours.

Exemples

L’exemple de code suivant montre comment inscrire un TraceContextEventHandler délégué pour gérer l’événement TraceFinished . Dans cet exemple, la OnTraceFinished méthode accède à la collection d’objets TraceContextRecord via la TraceRecords propriété , les itère et les écrit dans le flux de réponse.

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

Remarques

Chaque appel aux TraceContext.Write méthodes et TraceContext.Warn génère un TraceContextRecord objet qui est ajouté à la collection de TraceRecords messages. L’appel Warn de méthode définit la IsWarning propriété sur true, tandis que l’autre méthode appelle lui affecte la valeur false.

Vous pouvez itérer au sein des TraceRecords messages et examiner les enregistrements avec des catégories ou des messages spécifiques, et déterminer s’il s’agit d’avertissements.

Voir aussi

• TraceContextRecord
• TraceContextEventHandler
• TraceContext
• Vue d'ensemble du traçage ASP.NET