TraceContextEventArgs.TraceRecords Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá kolekci TraceContextRecord zpráv, které jsou přidruženy k aktuálnímu požadavku.
public:
property System::Collections::ICollection ^ TraceRecords { System::Collections::ICollection ^ get(); };
public System.Collections.ICollection TraceRecords { get; }
member this.TraceRecords : System.Collections.ICollection
Public ReadOnly Property TraceRecords As ICollection
Hodnota vlastnosti
Kolekce trasovacích záznamů, které jsou přidruženy k aktuálnímu požadavku.
Příklady
Následující příklad kódu ukazuje, jak můžete zaregistrovat delegáta TraceContextEventHandler pro zpracování TraceFinished události. V tomto příkladu OnTraceFinished
metoda přistupuje ke kolekci TraceContextRecord objektů prostřednictvím TraceRecords vlastnosti, iteruje je a zapisuje je do streamu odpovědi.
<%@ 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.
foreach(object o in e.TraceRecords)
{
r = (TraceContextRecord)o;
Response.Write(String.Format("trace message: {0} <BR>", r.Message));
}
}
</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.
For Each o In e.TraceRecords
r = CType(o, TraceContextRecord)
Response.Write(String.Format("trace message: {0} <BR>", r.Message))
Next
End Sub ' OnTraceFinished
</script>
Poznámky
Každé volání TraceContext.Write metod a TraceContext.Warn vygeneruje TraceContextRecord objekt, který je přidán do TraceRecords kolekce zpráv. Volání Warn metody nastaví IsWarning vlastnost na true
, zatímco ostatní volání metody ji nastaví na false
.
Můžete procházet TraceRecords zprávy a zkoumat záznamy s konkrétními kategoriemi nebo zprávami a zjistit, jestli se jedná o upozornění.