TraceContextEventArgs Класс

Определение

Предоставляет коллекцию записей трассировки в любой метод, который обрабатывает событие TraceFinished.Provides a collection of trace records to any method that handles the TraceFinished event. Этот класс не наследуется.This class cannot be inherited.

public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
    inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
Наследование
TraceContextEventArgs

Примеры

В следующем примере кода показано, как можно зарегистрировать TraceContextEventHandler делегат для выполнения TraceFinished события.The following code example demonstrates how you can register a TraceContextEventHandler delegate to handle the TraceFinished event. В этом примере OnTraceFinished метод обращается к TraceContextRecord коллекции объектов через TraceRecords свойство, выполняет итерацию по ним и записывает их в поток ответа.In this example, the OnTraceFinished method accesses the collection of TraceContextRecord objects through the TraceRecords property, iterates through them, and writes them to the response stream.

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

Комментарии

TraceContextEventArgs Класс используетсяTraceContext классом для предоставления доступа к записям трассировки после того, как все данные трассировки собраны во время обработки запроса HTTP.The TraceContextEventArgs class is used by the TraceContext class to provide access to trace records after all the tracing information is gathered during HTTP request processing. Добавляя делегат обработчика событий для обработки TraceFinished события, можно обрабатывать записи, записывать их в собственное хранилище данных или предоставлять в качестве входных данных средству профилирования.By adding an event handler delegate to handle the TraceFinished event, you can process the records, record them to your own data store, or provide them as input to a profiling tool.

Конструкторы

TraceContextEventArgs(ICollection)

Выполняет инициализацию нового экземпляра класса TraceContextEventArgs с использованием предоставленной коллекции записей трассировки.Initializes a new instance of the TraceContextEventArgs class, using the provided collection of trace records.

Свойства

TraceRecords

Возвращает коллекцию сообщений TraceContextRecord, связанных с текущим запросом.Gets a collection of TraceContextRecord messages that are associated with the current request.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно