TraceContextRecord Classe

Définition

Représente un message de trace ASP.NET et toutes les données associées.

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Héritage
TraceContextRecord

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 à travers eux 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

L’objet TraceContextRecord encapsule le message de trace, la catégorie, tout associé Exceptionet indique si l’enregistrement de trace a été écrit par la TraceContext.Warn méthode .

Chaque appel aux TraceContext.Write méthodes et TraceContext.Warn génère un TraceContextRecord objet qui est ajouté à la collection de TraceContextEventArgs.TraceRecords messages. Vous pouvez accéder à la collection d’enregistrements en gérant l’événement TraceFinished .

Constructeurs

TraceContextRecord(String, String, Boolean, Exception)

Initialise une nouvelle instance de la classe TraceContextRecord.

Propriétés

Category

Reçoit la catégorie définie par l'utilisateur pour l'enregistrement de trace.

ErrorInfo

Obtient le Exception associé à l'enregistrement de trace, si disponible.

IsWarning

Obtient une valeur indiquant si l'enregistrement de trace est associé à un appel de méthode Warn.

Message

Obtient le message de trace défini par l'utilisateur.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi