TraceContextEventArgs Класс

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Предоставляет коллекцию записей трассировки в любой метод, который обрабатывает событие TraceFinished. Этот класс не наследуется.

public sealed class TraceContextEventArgs : EventArgs

Наследование

Object

EventArgs

TraceContextEventArgs

Примеры

В следующем примере кода показано, как можно зарегистрировать делегата TraceContextEventHandler для обработки TraceFinished события. В этом примере OnTraceFinished метод обращается к коллекции TraceContextRecord объектов через TraceRecords свойство , выполняет их итерацию и записывает в поток ответа.

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

Комментарии

Класс TraceContextEventArgs используется классом для предоставления TraceContext доступа к записям трассировки после сбора всех сведений трассировки во время обработки HTTP-запроса. Добавив делегат обработчика событий для обработки TraceFinished события, можно обработать записи, записать их в собственное хранилище данных или предоставить в качестве входных данных для средства профилирования.

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

TraceContextEventArgs(ICollection)

Выполняет инициализацию нового экземпляра класса TraceContextEventArgs с использованием предоставленной коллекции записей трассировки.

Свойства

TraceRecords

Возвращает коллекцию сообщений TraceContextRecord, связанных с текущим запросом.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

См. также раздел

• TraceContextEventHandler
• TraceFinished
• TraceContext
• Общие сведения о трассировке ASP.NET