TraceContextRecord.Category Propriété

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Reçoit la catégorie définie par l'utilisateur pour l'enregistrement de trace.

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

public string Category { get; }

member this.Category : string

Public ReadOnly Property Category As String

Valeur de propriété

String

Chaîne représentant une catégorie de l'enregistrement de trace.

Exemples

L’exemple de code suivant montre comment accéder à la Category propriété d’un TraceContextRecord, puis l’imprimer et son message de trace associé dans le Response flux.

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

Remarques

La catégorie est utilisée pour mieux organiser les messages de trace en groupes reconnaissables, mais peut être n’importe quelle chaîne. La TraceContext classe utilise String.Empty comme catégorie par défaut pour les méthodes qui n’acceptent qu’un message paramètre. La catégorie par défaut pour ASP.NET, qui écrit plusieurs enregistrements de trace lorsque le suivi est activé, est « aspx.page ».

Voir aussi

• Vue d'ensemble du traçage ASP.NET