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žené k aktuálnímu požadavku.
Příklady
Následující příklad kódu ukazuje, jak můžete zaregistrovat TraceContextEventHandler delegáta TraceFinished pro zpracování události. V tomto příkladu OnTraceFinished metoda přistupuje k kolekci TraceContextRecord objektů prostřednictvím TraceRecords vlastnosti, iteruje je a zapíše 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 a metody generuje TraceContextRecord objekt, který je přidán do TraceRecords kolekce TraceContext.Warn zpráv. Volání Warn metody nastaví IsWarning vlastnost na true, zatímco ostatní volání metody nastavit na false.
Můžete iterovat TraceRecords zprávy a zkoumat záznamy s konkrétními kategoriemi nebo zprávami a to, jestli se jedná o upozornění.