TraceContextRecord.Category Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan kategori yang ditentukan pengguna untuk rekaman jejak.
public:
property System::String ^ Category { System::String ^ get(); };
public string Category { get; }
member this.Category : string
Public ReadOnly Property Category As String
Nilai Properti
String yang mewakili kategori untuk rekaman jejak.
Contoh
Contoh kode berikut menunjukkan cara mengakses Category properti dari TraceContextRecord, dan mencetaknya serta pesan jejak terkait ke Response
aliran.
<%@ 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>
Keterangan
Kategori ini digunakan untuk mengatur pesan pelacakan dengan lebih baik ke dalam grup yang dapat dikenali, tetapi dapat berupa string apa pun. Kelas TraceContext menggunakan String.Empty sebagai kategori default untuk metode yang hanya message
mengambil parameter. Kategori default untuk ASP.NET, yang menulis beberapa rekaman jejak saat pelacakan diaktifkan, adalah "aspx.page".