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 par le biais de TraceContextRecord 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, tous les éléments associés 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 les méthodes génère un TraceContextRecord objet ajouté à la TraceContextEventArgs.TraceRecords collection de messages. Vous pouvez accéder à la collection d’enregistrements en gérant l’événement TraceFinished .
Constructeurs
| Nom | Description |
|---|---|
| TraceContextRecord(String, String, Boolean, Exception) |
Initialise une nouvelle instance de la classe TraceContextRecord. |
Propriétés
| Nom | Description |
|---|---|
| Category |
Obtient la catégorie définie par l’utilisateur pour l’enregistrement de trace. |
| ErrorInfo |
Obtient l’enregistrement Exception de trace associé, le cas échéant. |
| IsWarning |
Obtient une valeur indiquant si l’enregistrement de trace est associé à un Warn appel de méthode. |
| Message |
Obtient le message de trace défini par l’utilisateur. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |