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


TraceContextRecord Класс

Определение

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

public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
Наследование
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 методов и TraceContext.Warn создает TraceContextRecord объект , который добавляется в коллекцию TraceContextEventArgs.TraceRecords сообщений. Доступ к коллекции записей можно получить, обрабатывая 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)

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

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