TraceContextEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un insieme di record di traccia a qualsiasi metodo che gestisce l'evento TraceFinished. La classe non può essere ereditata.
public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come registrare un TraceContextEventHandler delegato per gestire l'evento TraceFinished . In questo esempio il OnTraceFinished
metodo accede alla raccolta di oggetti tramite la TraceRecords proprietà , li scorre e li scrive nel flusso di TraceContextRecord risposta.
<%@ 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 dalla TraceContext classe per fornire l'accesso ai record di traccia dopo che tutte le informazioni di traccia vengono raccolte durante l'elaborazione delle richieste HTTP. Aggiungendo un delegato del gestore eventi per gestire l'evento TraceFinished , è possibile elaborare i record, registrarli nel proprio archivio dati o fornirli come input a uno strumento di profilatura.
Costruttori
TraceContextEventArgs(ICollection) |
Consente di inizializzare una nuova istanza della classe TraceContextEventArgs utilizzando l'insieme fornito di record di traccia. |
Proprietà
TraceRecords |
Ottiene un insieme di messaggi TraceContextRecord associati alla richiesta corrente. |
Metodi
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |