TraceContextRecord.Category Właściwość

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Pobiera kategorię zdefiniowaną przez użytkownika dla rekordu śledzenia.

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

public string Category { get; }

member this.Category : string

Public ReadOnly Property Category As String

Wartość właściwości

String

Ciąg reprezentujący kategorię rekordu śledzenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak uzyskać dostęp do Category właściwości elementu TraceContextRecordi wydrukować go oraz skojarzony komunikat śledzenia do strumienia Response .

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

Uwagi

Kategoria służy do lepszego organizowania komunikatów śledzenia w rozpoznawalnych grupach, ale może być dowolnym ciągiem. Klasa TraceContext używa String.Empty jako domyślnej kategorii metod, które przyjmują tylko message parametr. Domyślna kategoria ASP.NET, która zapisuje kilka rekordów śledzenia po włączeniu śledzenia, to "aspx.page".

Zobacz też

• Omówienie śledzenia ASP.NET