Partager via


TraceContextEventArgs.TraceRecords Propriété

Définition

Obtient une collection de TraceContextRecord messages associés à la requête actuelle.

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é

Collection d’enregistrements de trace associés à la requête actuelle.

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 par le biais de TraceContextRecord 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 les méthodes génère un TraceContextRecord objet ajouté à la TraceRecords collection de messages. L’appel Warn de méthode définit la IsWarning propriété truesur , tandis que l’autre méthode l’appelle false.

Vous pouvez effectuer une itération dans les TraceRecords messages et examiner les enregistrements avec des catégories ou des messages spécifiques, et déterminer s’ils sont des avertissements.

S’applique à

Voir aussi