TraceContextRecord.Category Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die benutzerdefinierte Kategorie für den Ablaufverfolgungsdatensatz ab.
public:
property System::String ^ Category { System::String ^ get(); };
public string Category { get; }
member this.Category : string
Public ReadOnly Property Category As String
Eigenschaftswert
Eine Zeichenfolge, die eine Kategorie für den Ablaufverfolgungsdatensatz darstellt.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie auf die Category -Eigenschaft eines TraceContextRecord-Objekts zugreifen und sie und die zugehörige Ablaufverfolgungsnachricht im Response
Stream ausgeben.
<%@ 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>
Hinweise
Die Kategorie wird verwendet, um Ablaufverfolgungsmeldungen besser in erkennbare Gruppen zu organisieren, kann jedoch eine beliebige Zeichenfolge sein. Die TraceContext -Klasse verwendet String.Empty als Standardkategorie für Methoden, die nur einen message
Parameter verwenden. Die Standardkategorie für ASP.NET, die mehrere Ablaufverfolgungsdatensätze schreibt, wenn die Ablaufverfolgung aktiviert ist, ist "aspx.page".
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für