Export (0) Print
Expand All

TraceContextRecord.Category Property

Gets the user-defined category for the trace record.

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

public string Category { get; }

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="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.
    Response.Write("<table>");
    foreach(object o in e.TraceRecords)
    {
        r = (TraceContextRecord)o;
        Response.Write(String.Format("<tr><td>{0}</td><td>{1}</td></tr>", r.Message, r.Category));        
    }
    Response.Write("</table>");
}       
</script>


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft