TraceContextEventArgs Classe

Definizione

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
Ereditarietà
TraceContextEventArgs

Esempi

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

Commenti

La TraceContextEventArgs classe viene utilizzata TraceContext dalla classe 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' TraceFinished evento, è 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.

Costruttori

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.

Proprietà

TraceRecords

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

Metodi

Equals(Object)

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

(Ereditato da Object)
GetHashCode()

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

(Ereditato da Object)
GetType()

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

(Ereditato da Object)
MemberwiseClone()

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

(Ereditato da Object)
ToString()

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

(Ereditato da Object)

Si applica a

Vedi anche