TraceContext Class

Definition

Capture et présente les détails d'exécution relatifs à une demande Web.Captures and presents execution details about a Web request. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class TraceContext sealed
public sealed class TraceContext
type TraceContext = class
Public NotInheritable Class TraceContext
Inheritance
TraceContext

Remarks

Vous pouvez utiliser cette classe pour ajouter des messages à des catégories de trace spécifiques.You can use this class to append messages to specific trace categories. Par exemple, si vous créez une instance de la classe Calendar pour votre application, vous pouvez inclure le message de trace « démarrage du rendu » dans une procédure de rendu et « déclenchement de l’événement OnChange » dans une procédure de gestionnaire d’événements.For example, if you are creating an instance of the Calendar class for your application, you might include the trace message "Starting To Render" in a rendering procedure, and "Raising OnChange Event" in an event handler procedure.

Vous pouvez également utiliser la classe TraceContext pour obtenir un ensemble d’enregistrements de trace à la fin de l’exécution de la demande en vue d’un traitement personnalisé.You can also use the TraceContext class to obtain a set of trace records at the end of request execution for custom processing. Pour plus d’informations, consultez vue d’ensemble du suivi ASP.net.For more information, see ASP.NET Tracing Overview.

Pour activer le suivi, affectez à l’attribut Trace dans la directive @ page ou à la propriété IsEnabled la valeur true.To enable tracing, set the Trace attribute in the @ Page directive or the IsEnabled property to true. Lorsque le traçage est activé, outre l’indication du contenu de trace fourni par l’utilisateur, la classe Page comprend automatiquement les données de performances, les informations de structure de l’arborescence de contrôle et le contenu de gestion d’État pour chaque demande.When tracing is enabled, in addition to showing user-provided trace content, the Page class automatically includes performance data, control-tree structure information, and state management content for every request.

Constructors

TraceContext(HttpContext)

Initialise une nouvelle instance de la classe TraceContext.Initializes a new instance of the TraceContext class.

Properties

IsEnabled

Obtient ou définit une valeur indiquant si le traçage est activé pour la demande Web en cours.Gets or sets a value indicating whether tracing is enabled for the current Web request.

TraceMode

Obtient ou définit l'ordre trié dans lequel les messages de trace doivent être générés sur un navigateur demandeur.Gets or sets the sorted order in which trace messages should be output to a requesting browser.

Methods

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
Warn(String)

Écrit un message de trace dans le journal des traces.Writes a trace message to the trace log. Tous les avertissements s'affichent dans le journal en texte rouge.All warnings appear in the log as red text.

Warn(String, String)

Écrit dans le journal des traces des informations de traçage incluant toutes les catégories définies par l'utilisateur et des messages de trace.Writes trace information to the trace log, including any user-defined categories and trace messages. Tous les avertissements s'affichent dans le journal en texte rouge.All warnings appear in the log as red text.

Warn(String, String, Exception)

Écrit dans le journal des traces des informations de traçage incluant toutes les catégories définies par l'utilisateur, des messages de trace, ainsi que des informations relatives aux erreurs.Writes trace information to the trace log, including any user-defined categories, trace messages, and error information. Tous les avertissements s'affichent dans le journal en texte rouge.All warnings appear in the log as red text.

Write(String)

Écrit un message de trace dans le journal des traces.Writes a trace message to the trace log.

Write(String, String)

Écrit dans le journal des traces des informations de traçage incluant un message et toutes les catégories définies par l'utilisateur.Writes trace information to the trace log, including a message and any user-defined categories.

Write(String, String, Exception)

Écrit dans le journal des traces des informations de traçage incluant toutes les catégories définies par l'utilisateur, des messages de trace, ainsi que des informations relatives aux erreurs.Writes trace information to the trace log, including any user-defined categories, trace messages, and error information.

Events

TraceFinished

Déclenché par l'objet TraceContext pour exposer des messages de trace une fois que toutes les informations de demande ont été rassemblées.Raised by the TraceContext object to expose trace messages after all request information is gathered.

Applies to

See also