TraceContextRecord.Category Property

 

Gets the user-defined category for the trace record.

Namespace:   System.Web
Assembly:  System.Web (in System.Web.dll)

Public ReadOnly Property Category As String

Property Value

Type: System.String

A string that represents a category for the trace record.

The category is used to better organize trace messages into recognizable groups, but can be any string. The TraceContext class uses String.Empty as its default category for methods that take only a message parameter. The default category for ASP.NET, which writes several trace records when tracing is enabled, is "aspx.page".

The following code example demonstrates how to access the Category property of a TraceContextRecord, and print it and its associated trace message to the Response stream.

<%@ 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.
    Response.Write("<table>")
    For Each o In e.TraceRecords
        r = CType(o, TraceContextRecord)
        Response.Write(String.Format("<tr><td>{0}</td><td>{1}</td></tr>", r.Message, r.Category))
    Next
    Response.Write("</table>")

End Sub ' OnTraceFinished
</script>

.NET Framework
Available since 2.0
Return to top
Show: