Udostępnij za pośrednictwem

TraceContextRecord Klasa

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Reprezentuje komunikat śledzenia ASP.NET i wszystkie skojarzone dane.

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Dziedziczenie
Object
TraceContextRecord

Przykłady

W poniższym przykładzie kodu pokazano, jak zarejestrować delegata TraceContextEventHandler w celu obsługi TraceFinished zdarzenia. W tym przykładzie OnTraceFinished metoda uzyskuje dostęp do kolekcji TraceContextRecord obiektów za pośrednictwem TraceRecords właściwości, iteruje przez nie i zapisuje je w strumieniu odpowiedzi.

<%@ 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>

Uwagi

Obiekt TraceContextRecord hermetyzuje komunikat śledzenia, kategorię, wszystkie skojarzone rekordy Exceptioni czy rekord śledzenia został zapisany przez metodę TraceContext.Warn .

Każde wywołanie TraceContext.Write metody i TraceContext.Warn generuje TraceContextRecord obiekt dodawany do kolekcji komunikatów TraceContextEventArgs.TraceRecords . Dostęp do kolekcji rekordów można uzyskać, obsługując TraceFinished zdarzenie.

Konstruktory

Nazwa Opis
TraceContextRecord(String, String, Boolean, Exception)

Inicjuje nowe wystąpienie klasy TraceContextRecord.

Właściwości

Nazwa Opis
Category

Pobiera kategorię zdefiniowaną przez użytkownika dla rekordu śledzenia.
ErrorInfo

Exception Pobiera element skojarzony z rekordem śledzenia, jeśli jest dostępny.
IsWarning

Pobiera wartość wskazującą, czy rekord śledzenia jest skojarzony z wywołaniem Warn metody.
Message

Pobiera komunikat śledzenia zdefiniowany przez użytkownika.

Metody

Nazwa Opis
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też