TraceContextRecord.Category Propiedad

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Obtiene la categoría definida por el usuario para el registro de seguimiento.

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

public string Category { get; }

member this.Category : string

Public ReadOnly Property Category As String

Valor de propiedad

String

Cadena que representa una categoría para el registro de seguimiento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener acceso a la Category propiedad de , TraceContextRecorde imprimirla y su mensaje de seguimiento asociado a la Response secuencia.

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

Comentarios

La categoría se usa para organizar mejor los mensajes de seguimiento en grupos reconocibles, pero puede ser cualquier cadena. La TraceContext clase usa String.Empty como su categoría predeterminada para los métodos que toman solo un message parámetro. La categoría predeterminada para ASP.NET, que escribe varios registros de seguimiento cuando el seguimiento está habilitado, es "aspx.page".

Consulte también

• Información general sobre la traza de ASP.NET