TraceContextRecord Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un message de trace ASP.NET et toutes les données associées.
public ref class TraceContextRecord sealed
public sealed class TraceContextRecord
type TraceContextRecord = class
Public NotInheritable Class TraceContextRecord
- Héritage
-
TraceContextRecord
Exemples
L’exemple de code suivant montre comment inscrire un TraceContextEventHandler délégué pour gérer l’événement TraceFinished . Dans cet exemple, la OnTraceFinished
méthode accède à la collection d’objets TraceContextRecord via la TraceRecords propriété , les itère et les écrit dans le flux de réponse.
<%@ 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>
Remarques
L’objet TraceContextRecord encapsule le message de trace, la catégorie, tout associé Exceptionet indique si l’enregistrement de trace a été écrit par la TraceContext.Warn méthode .
Chaque appel aux TraceContext.Write méthodes et TraceContext.Warn génère un TraceContextRecord objet qui est ajouté à la collection de TraceContextEventArgs.TraceRecords messages. Vous pouvez accéder à la collection d’enregistrements en gérant l’événement TraceFinished .
Constructeurs
TraceContextRecord(String, String, Boolean, Exception) |
Initialise une nouvelle instance de la classe TraceContextRecord. |
Propriétés
Category |
Reçoit la catégorie définie par l'utilisateur pour l'enregistrement de trace. |
ErrorInfo |
Obtient le Exception associé à l'enregistrement de trace, si disponible. |
IsWarning |
Obtient une valeur indiquant si l'enregistrement de trace est associé à un appel de méthode Warn. |
Message |
Obtient le message de trace défini par l'utilisateur. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |