TraceContextEventArgs Klasa

Definicja

Udostępnia kolekcję rekordów śledzenia do dowolnej metody, która obsługuje TraceFinished zdarzenie. Klasa ta nie może być dziedziczona.

public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
    inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
Dziedziczenie
TraceContextEventArgs

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 je 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

Klasa TraceContextEventArgs jest używana przez klasę TraceContext w celu zapewnienia dostępu do rekordów śledzenia po zebraniu wszystkich informacji śledzenia podczas przetwarzania żądań HTTP. Dodając delegata programu obsługi zdarzeń do obsługi TraceFinished zdarzenia, można przetworzyć rekordy, zarejestrować je we własnym magazynie danych lub podać je jako dane wejściowe do narzędzia profilowania.

Konstruktory

TraceContextEventArgs(ICollection)

Inicjuje TraceContextEventArgs nowe wystąpienie klasy przy użyciu udostępnionej kolekcji rekordów śledzenia.

Właściwości

TraceRecords

Pobiera kolekcję komunikatów skojarzonych TraceContextRecord z bieżącym żądaniem.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

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

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

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

(Odziedziczone po Object)
ToString()

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

(Odziedziczone po Object)

Dotyczy

Zobacz też