TraceContextEventArgs.TraceRecords Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling TraceContextRecord berichten op die zijn gekoppeld aan de huidige aanvraag.
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
Waarde van eigenschap
Een verzameling traceringsrecords die zijn gekoppeld aan de huidige aanvraag.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een TraceContextEventHandler gemachtigde kunt registreren om de TraceFinished gebeurtenis af te handelen. In dit voorbeeld heeft de OnTraceFinished methode toegang tot de verzameling TraceContextRecord objecten via de TraceRecords eigenschap, doorloopt deze en schrijft deze naar de antwoordstroom.
<%@ 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>
Opmerkingen
Elke aanroep naar de TraceContext.Write en TraceContext.Warn methoden genereert een TraceContextRecord object dat wordt toegevoegd aan de TraceRecords berichtenverzameling. Met Warn de methode-aanroep wordt de IsWarning eigenschap ingesteld op true, terwijl de andere methode deze instelt op false.
U kunt de TraceRecords berichten herhalen en records onderzoeken met specifieke categorieƫn of berichten en of het waarschuwingen zijn.