TraceContextEventArgs 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.
Fournit une collection d'enregistrements de trace à toutes les méthodes gérant l'événement TraceFinished. Cette classe ne peut pas être héritée.
public ref class TraceContextEventArgs sealed : EventArgs
public sealed class TraceContextEventArgs : EventArgs
type TraceContextEventArgs = class
inherit EventArgs
Public NotInheritable Class TraceContextEventArgs
Inherits EventArgs
- Héritage
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 à travers eux 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
La TraceContextEventArgs classe est utilisée par la classe pour fournir l’accès TraceContext aux enregistrements de trace une fois que toutes les informations de suivi ont été collectées pendant le traitement des requêtes HTTP. En ajoutant un délégué de gestionnaire d’événements pour gérer l’événement TraceFinished , vous pouvez traiter les enregistrements, les enregistrer dans votre propre magasin de données ou les fournir en entrée dans un outil de profilage.
Constructeurs
TraceContextEventArgs(ICollection) |
Initialise une nouvelle instance de la classe TraceContextEventArgs à l'aide de la collection d'enregistrements de trace fournie. |
Propriétés
TraceRecords |
Obtient une collection de messages TraceContextRecord associés à la demande en cours. |
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) |