Поделиться через

TraceContextRecord Класс

Определение

Пространство имен:
System.Web
Сборка:
System.Web.dll

Представляет сообщение трассировки ASP.NET и все связанные данные.

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Наследование
Object
TraceContextRecord

Примеры

В следующем примере кода показано, как зарегистрировать 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>

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

Комментарии

Объект TraceContextRecord инкапсулирует сообщение трассировки, категорию, любую связанную Exceptionи запись трассировки, написанную методом TraceContext.Warn .

Каждый вызов TraceContext.Write и методы TraceContextRecord создают объект, добавляемый в коллекцию TraceContextEventArgs.TraceRecordsTraceContext.Warn сообщений. Вы можете получить доступ к коллекции записей, обрабатывая TraceFinished событие.

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

Имя Описание
TraceContextRecord(String, String, Boolean, Exception)

Инициализирует новый экземпляр класса TraceContextRecord.

Свойства

Имя Описание
Category

Возвращает определяемую пользователем категорию для записи трассировки.
ErrorInfo

Получает связанную Exception с записью трассировки, если она доступна.
IsWarning

Возвращает значение, указывающее, связана ли запись трассировки с вызовом Warn метода.
Message

Возвращает определяемое пользователем сообщение трассировки.

Методы

Имя Описание
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

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

Служит хэш-функцией по умолчанию.

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

Возвращает Type текущего экземпляра.

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

Создает неглубокую копию текущей Object.

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

Возвращает строку, представляющую текущий объект.

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

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

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