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 una raccolta di record di traccia a qualsiasi metodo che gestisce l'evento TraceFinished . Questa 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 TraceContextRecord oggetti tramite la TraceRecords proprietà , li scorre e li scrive nel flusso di 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 usata 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 specificarli come input per uno strumento di profilatura.
Costruttori
| Nome | Descrizione |
|---|---|
| TraceContextEventArgs(ICollection) |
Inizializza una nuova istanza della TraceContextEventArgs classe utilizzando la raccolta fornita di record di traccia. |
Proprietà
| Nome | Descrizione |
|---|---|
| TraceRecords |
Ottiene una raccolta di TraceContextRecord messaggi associati alla richiesta corrente. |
Metodi
| Nome | Descrizione |
|---|---|
| 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 il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |