TraceContextRecord.Category Vlastnost

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Získá uživatelem definované kategorie pro záznam trasování.

public:
 property System::String ^ Category { System::String ^ get(); };

public string Category { get; }

member this.Category : string

Public ReadOnly Property Category As String

Hodnota vlastnosti

String

Řetězec, který představuje kategorii záznamu trasování.

Příklady

Následující příklad kódu ukazuje, jak získat přístup Category k vlastnosti objektu TraceContextRecorda vytisknout ji a její přidruženou zprávu trasování do datového Response proudu.

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

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

Poznámky

Kategorie se používá k lepšímu uspořádání trasovacích zpráv do rozpoznatelných skupin, ale může to být libovolný řetězec. Třída TraceContext používá String.Empty jako výchozí kategorii pro metody, které přebírají pouze message parametr. Výchozí kategorie pro ASP.NET, která při povoleném trasování zapisuje několik trasovacích záznamů, je "aspx.page".

Viz také

• Přehled trasování ASP.NET