TraceContext 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.
Capture et présente les détails d'exécution relatifs à une demande Web. Cette classe ne peut pas être héritée.
public ref class TraceContext sealed
public sealed class TraceContext
type TraceContext = class
Public NotInheritable Class TraceContext
- Héritage
-
TraceContext
Remarques
Vous pouvez utiliser cette classe pour ajouter des messages à des catégories de traces spécifiques. Par exemple, si vous créez une instance de la Calendar classe pour votre application, vous pouvez inclure le message de trace « Starting To Render » dans une procédure de rendu et « Raising OnChange Event » dans une procédure de gestionnaire d’événements.
Vous pouvez également utiliser la TraceContext classe pour obtenir un ensemble d’enregistrements de trace à la fin de l’exécution de la demande pour un traitement personnalisé. Pour plus d’informations, consultez Vue d’ensemble du suivi ASP.NET.
Pour activer le suivi, définissez l’attribut Trace
dans la directive @ Page ou la propriété sur IsEnabledtrue
. Lorsque le suivi est activé, en plus d’afficher le contenu de trace fourni par l’utilisateur, la Page classe inclut automatiquement des données de performances, des informations sur la structure de l’arborescence de contrôle et du contenu de gestion d’état pour chaque requête.
Constructeurs
TraceContext(HttpContext) |
Initialise une nouvelle instance de la classe TraceContext. |
Propriétés
IsEnabled |
Obtient ou définit une valeur indiquant si le traçage est activé pour la demande Web en cours. |
TraceMode |
Obtient ou définit l'ordre trié dans lequel les messages de trace doivent être générés sur un navigateur demandeur. |
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) |
Warn(String) |
Écrit un message de trace dans le journal des traces. Tous les avertissements s'affichent dans le journal en texte rouge. |
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. Tous les avertissements s'affichent dans le journal en texte rouge. |
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. Tous les avertissements s'affichent dans le journal en texte rouge. |
Write(String) |
Écrit un message de trace dans le journal des traces. |
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. |
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. |
Événements
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. |