TraceContextEventArgs Class

Definition

Fornisce un insieme di record di traccia a qualsiasi metodo che gestisce l'evento TraceFinished.Provides a collection of trace records to any method that handles the TraceFinished event. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
    inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
Inheritance
TraceContextEventArgs

Examples

Nell'esempio di codice riportato di seguito viene illustrato come registrare un delegato TraceContextEventHandler per gestire l'evento TraceFinished.The following code example demonstrates how you can register a TraceContextEventHandler delegate to handle the TraceFinished event. In questo esempio, il metodo OnTraceFinished accede alla raccolta di oggetti TraceContextRecord tramite la proprietà TraceRecords, ne esegue l'iterazione e li scrive nel flusso di risposta.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>

Remarks

La classe TraceContextEventArgs viene utilizzata dalla classe TraceContext per fornire l'accesso ai record di traccia dopo la raccolta di tutte le informazioni di traccia durante l'elaborazione della richiesta HTTP.The TraceContextEventArgs class is used by the TraceContext class to provide access to trace records after all the tracing information is gathered during HTTP request processing. Aggiungendo un delegato del gestore eventi per gestire l'evento TraceFinished, è possibile elaborare i record, registrarli nel proprio archivio dati o fornirli come input per uno strumento di profilatura.By adding an event handler delegate to handle the TraceFinished event, you can process the records, record them to your own data store, or provide them as input to a profiling tool.

Constructors

TraceContextEventArgs(ICollection)

Consente di inizializzare una nuova istanza della classe TraceContextEventArgs utilizzando l'insieme fornito di record di traccia.Initializes a new instance of the TraceContextEventArgs class, using the provided collection of trace records.

Properties

TraceRecords

Ottiene un insieme di messaggi TraceContextRecord associati alla richiesta corrente.Gets a collection of TraceContextRecord messages that are associated with the current request.

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also