TraceContextRecord.Category Eigenschap

Definitie

Naamruimte:
System.Web
Assembly:
System.Web.dll

Hiermee haalt u de door de gebruiker gedefinieerde categorie voor de traceringsrecord op.

public:
 property System::String ^ Category { System::String ^ get(); };
public string Category { get; }
member this.Category : string
Public ReadOnly Property Category As String

Waarde van eigenschap

String

Een tekenreeks die een categorie vertegenwoordigt voor de traceringsrecord.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u toegang hebt tot de Category eigenschap van een TraceContextRecord, en hoe u deze en het bijbehorende traceringsbericht naar de Response stream afdrukt.

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

Opmerkingen

De categorie wordt gebruikt om traceringsberichten beter te ordenen in herkenbare groepen, maar kan elke tekenreeks zijn. De TraceContext klasse gebruikt String.Empty als standaardcategorie voor methoden die alleen een message parameter gebruiken. De standaardcategorie voor ASP.NET, die verschillende traceringsrecords schrijft wanneer tracering is ingeschakeld, is 'aspx.page'.

Van toepassing op

Zie ook