TraceContextRecord 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.
Rappresenta un messaggio di traccia di ASP.NET ed eventuali dati associati.
public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
- Ereditarietà
-
TraceContextRecord
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 esegue 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
L'oggetto TraceContextRecord incapsula il messaggio di traccia, la categoria, qualsiasi oggetto associato Exceptione se il record di traccia è stato scritto dal TraceContext.Warn metodo .
Ogni chiamata ai TraceContext.Write metodi e TraceContext.Warn genera un TraceContextRecord oggetto aggiunto alla TraceContextEventArgs.TraceRecords raccolta messaggi. È possibile accedere alla raccolta di record gestendo l'evento TraceFinished .
Costruttori
TraceContextRecord(String, String, Boolean, Exception) |
Inizializza una nuova istanza della classe TraceContextRecord. |
Proprietà
Category |
Ottiene la categoria definita dall'utente per il record di traccia. |
ErrorInfo |
Ottiene l'oggetto Exception associato al record di traccia, se disponibile. |
IsWarning |
Ottiene un valore che indica se il record di traccia è associato a una chiamata al metodo Warn. |
Message |
Ottiene il messaggio di traccia definito dall'utente. |
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) |