TraceContextRecord.Category Eigenschaft

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Ruft die benutzerdefinierte Kategorie für den Ablaufverfolgungsdatensatz ab.

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

public string Category { get; }

member this.Category : string

Public ReadOnly Property Category As String

Eigenschaftswert

String

Eine Zeichenfolge, die eine Kategorie für den Ablaufverfolgungsdatensatz darstellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie auf die Category Eigenschaft eines TraceContextRecordzugreifen und sie und die zugehörige Ablaufverfolgungsnachricht im Response Stream drucken.

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

Hinweise

Die Kategorie wird verwendet, um Ablaufverfolgungsmeldungen besser in erkennbaren Gruppen zu organisieren, kann jedoch eine beliebige Zeichenfolge sein. Die TraceContext -Klasse verwendet String.Empty als Standardkategorie für Methoden, die nur einen message Parameter verwenden. Die Standardkategorie für ASP.NET, in der mehrere Ablaufverfolgungsdatensätze geschrieben werden, wenn die Ablaufverfolgung aktiviert ist, ist "aspx.page".

Weitere Informationen

• Übersicht über die ASP.NET-Ablaufverfolgung