System.Diagnostics Espace de noms
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 des classes qui vous permettent d’interagir avec des processus système, des journaux des événements et des compteurs de performance.
Classes
Activity |
Représente une opération avec le contexte à utiliser pour la journalisation. |
ActivityListener |
Permet d’écouter les événements d’activité de démarrage et d’arrêt et offre l’opportunité de décider de créer une activité pour les scénarios d’échantillonnage. |
ActivitySource |
Fournit des API permettant de créer et de démarrer des objets Activity et d’inscrire des objets ActivityListener pour écouter les événements Activity . |
ActivityTagsCollection |
ActivityTagsCollection est une classe de collection utilisée pour stocker des balises de suivi. Cette collection est utilisée avec des classes comme ActivityEvent et ActivityLink. Cette collection se comporte comme suit :
|
BooleanSwitch |
Fournit un simple commutateur marche/arrêt qui contrôle le débogage et la sortie de suivi. |
ConditionalAttribute |
Indique aux compilateurs qu'un appel ou un attribut de méthode doit être ignoré, sauf si un symbole de compilation conditionnelle spécifié est défini. |
ConsoleTraceListener |
Dirige la sortie de traçage ou de débogage vers la sortie standard ou le flux d'erreurs standard. |
CorrelationManager |
Met en correspondance des traces qui font partie d'une transaction logique. |
CounterCreationData |
Définit le type, le nom et la chaîne d'aide d'un compteur personnalisé. |
CounterCreationDataCollection |
Fournit une collection fortement typée d’objets CounterCreationData. |
CounterSampleCalculator |
Fournit un ensemble de fonctions utilitaires pour l'interprétation des données du compteur de performance. |
DataReceivedEventArgs |
Fournit des données pour les événements OutputDataReceived et ErrorDataReceived. |
Debug |
Fournit un ensemble de méthodes et propriétés qui permettent de déboguer votre code. |
DebuggableAttribute |
Modifie la génération de code pour le débogage juste-à-temps (JIT) du runtime. Cette classe ne peut pas être héritée. |
Debugger |
Active la communication avec un débogueur. Cette classe ne peut pas être héritée. |
DebuggerBrowsableAttribute |
Détermine si et comment un membre est affiché dans les fenêtres de variables du débogueur. Cette classe ne peut pas être héritée. |
DebuggerDisplayAttribute |
Détermine la façon dont une classe ou un champ s'affiche dans les fenêtres de variables du débogueur. |
DebuggerHiddenAttribute |
Spécifie DebuggerHiddenAttribute. Cette classe ne peut pas être héritée. |
DebuggerNonUserCodeAttribute |
Identifie un type ou membre qui ne fait pas partie du code utilisateur pour une application. |
DebuggerStepperBoundaryAttribute |
Indique que le code qui suit l'attribut doit être exécuté en mode exécution, pas en mode pas à pas. |
DebuggerStepThroughAttribute |
Configure le débogueur pour parcourir le code au lieu d'effectuer un pas à pas détaillé. Cette classe ne peut pas être héritée. |
DebuggerTypeProxyAttribute |
Spécifie le proxy d'affichage pour un type. |
DebuggerVisualizerAttribute |
Spécifie que le type possède un visualiseur. Cette classe ne peut pas être héritée. |
DefaultTraceListener |
Fournit les méthodes de sortie par défaut et le comportement de suivi. |
DelimitedListTraceListener |
Dirige la sortie de trace ou de débogage vers un TextWriter, tel qu'un writer de flux, ou vers un flux, tel qu'un flux de fichier. |
DiagnosticListener |
Fournit une implémentation de la classe DiagnosticSource abstraite qui représente un emplacement nommé auquel une source envoie ses informations (événements). |
DiagnosticListenerExtensions |
Fournit des classes qui vous permettent d’interagir avec des processus système, des journaux des événements et des compteurs de performance. |
DiagnosticsConfigurationHandler |
Gère la section de diagnostic des fichiers de configuration. |
DiagnosticSource |
Classe abstraite qui permet d’instrumenter le code pour la journalisation en production des charges enrichies à consommer dans le processus qui a été instrumenté. |
DistributedContextPropagator |
Une implémentation de DistributedContextPropagator détermine si et comment les informations de contexte distribuées sont encodées et décodées à mesure qu’elles traversent le réseau. Le codage peut être transporté sur n’importe quel protocole réseau qui prend en charge les paires clé-valeur de chaîne. Par exemple, lors de l’utilisation de HTTP, chaque paire clé-valeur est un en-tête HTTP. DistributedContextPropagator injecte des valeurs dans et extrait des valeurs des opérateurs sous forme de paires clé-valeur de chaîne. |
EntryWrittenEventArgs |
Fournit des données pour l'événement EntryWritten. |
EventInstance |
Représente des informations indépendantes du langage pour une entrée du journal des événements. |
EventLog |
Fournit une interaction avec les journaux des événements Windows. |
EventLogEntry |
Encapsule un enregistrement unique dans le journal des événements. Cette classe ne peut pas être héritée. |
EventLogEntryCollection |
Définit la taille et les énumérateurs pour une collection d’instances de EventLogEntry. |
EventLogInstaller |
Vous permet d'installer et de configurer un journal des événements que votre application lit et dans lequel elle écrit pendant l'exécution. |
EventLogPermission |
Contrôle les autorisations d'accès du code pour le journal des événements. |
EventLogPermissionAttribute |
Permet les vérifications déclaratives des autorisations d’accès pour la journalisation des événements. |
EventLogPermissionEntry |
Définit la plus petite unité d'une autorisation de sécurité d'accès du code définie pour un EventLog. |
EventLogPermissionEntryCollection |
Contient une collection fortement typée d’objets EventLogPermissionEntry. |
EventLogTraceListener |
Fournit un écouteur simple qui dirige la sortie de traçage ou de débogage vers un EventLog. |
EventSchemaTraceListener |
Dirige la sortie du traçage ou du débogage d'événements de bout en bout vers un fichier journal encodé XML conforme au schéma. |
EventSourceCreationData |
Représente les paramètres de configuration utilisés pour créer une source de journal des événements sur l'ordinateur local ou un ordinateur distant. |
EventTypeFilter |
Indique si un écouteur doit tracer en fonction du type d'événement. |
FileVersionInfo |
Fournit des informations sur la version d'un fichier physique figurant sur le disque. |
InitializingSwitchEventArgs |
Fournit des données pour l’événement Switch.Initializing . |
InitializingTraceSourceEventArgs |
Fournit des données pour l’événement TraceSource.Initializing . |
InstanceData |
Contient les données de l'instance associées à un échantillon de compteur de performance. |
InstanceDataCollection |
Fournit une collection fortement typée d’objets InstanceData. |
InstanceDataCollectionCollection |
Fournit une collection fortement typée d’objets InstanceDataCollection. |
MonitoringDescriptionAttribute |
Spécifie une description pour une propriété ou un événement. |
PerformanceCounter |
Représente un composant de compteur de performances Windows NT. |
PerformanceCounterCategory |
Représente un objet de performance qui définit une catégorie de compteurs de performance. |
PerformanceCounterInstaller |
Spécifie un programme d’installation pour le composant PerformanceCounter . |
PerformanceCounterManager |
Prépare les données de performance pour le fichier performance.dll que le système charge lorsqu'il travaille avec les compteurs de performance. |
PerformanceCounterPermission |
Permet de contrôler les autorisations d'accès du code pour PerformanceCounter. |
PerformanceCounterPermissionAttribute |
Permet de vérifier les autorisations de compteurs de performance déclaratives. |
PerformanceCounterPermissionEntry |
Définit la plus petite unité d'une autorisation de sécurité d'accès du code définie pour PerformanceCounter. |
PerformanceCounterPermissionEntryCollection |
Contient une collection fortement typée d’objets PerformanceCounterPermissionEntry. |
PresentationTraceSources |
Fournit la prise en charge du suivi du débogage spécifiquement ciblé pour les applications WPF (Windows Presentation Foundation). |
Process |
Fournit l'accès à des processus locaux ainsi que distants, et vous permet de démarrer et d'arrêter des processus système locaux. |
ProcessModule |
Représente un fichier .dll ou .exe chargé dans un processus particulier. |
ProcessModuleCollection |
Fournit une collection fortement typée d’objets ProcessModule. |
ProcessStartInfo |
Spécifie un jeu de valeurs utilisées lors du démarrage d'un processus. |
ProcessThread |
Représente un thread de processus du système d'exploitation. |
ProcessThreadCollection |
Fournit une collection fortement typée d’objets ProcessThread. |
SourceFilter |
Indique si un écouteur doit tracer un message en fonction de la source d'un traçage. |
SourceSwitch |
Fournit un commutateur à plusieurs niveaux pour contrôler la sortie de traçage et de débogage sans recompiler votre code. |
StackFrame |
Fournit des informations sur un StackFrame, qui représente un appel de fonction sur la pile des appels du thread en cours. |
StackFrameExtensions |
Fournit des méthodes d’extension pour la classe StackFrame, qui représente un appel de fonction sur la pile des appels du thread actuel. |
StackTrace |
Représente une trace de la pile, à savoir une collection ordonnée de frames de pile. |
StackTraceHiddenAttribute |
Les types et les méthodes avec l’attribut StackTraceHidden seront omis du texte de trace de pile affiché dans StackTrace.ToString() et Exception.StackTrace |
Stopwatch |
Fournit un jeu de méthodes et de propriétés que vous pouvez utiliser pour mesurer le temps écoulé précisément. |
Switch |
Fournit une classe de base abstraite pour créer des commutateurs de débogage et de traçage. |
SwitchAttribute |
Identifie un commutateur utilisé dans un assembly, une classe ou un membre. |
SwitchLevelAttribute |
Identifie le type de niveau pour un commutateur. |
TextWriterTraceListener |
Dirige la sortie de traçage ou de débogage vers TextWriter ou Stream, tel que FileStream. |
Trace |
Fournit un ensemble de méthodes et de propriétés qui vous permettent de tracer l'exécution de votre code. Cette classe ne peut pas être héritée. |
TraceConfiguration |
Fournit des classes qui vous permettent d’interagir avec des processus système, des journaux des événements et des compteurs de performance. |
TraceEventCache |
Fournit les données d'événement de trace spécifiques à un thread et un processus. |
TraceFilter |
Fournit la classe de base pour les implémentations du filtre de la trace. |
TraceListener |
Fournit la classe de base |
TraceListenerCollection |
Fournit une liste thread-safe d’objets TraceListener. |
TraceSource |
Fournit un jeu de méthodes et de propriétés qui permet aux applications d'effectuer le suivi de l'exécution du code et des messages de trace associés à leur source. |
TraceSwitch |
Fournit un commutateur à plusieurs niveaux pour contrôler la sortie de traçage et de débogage sans recompiler votre code. |
UnescapedXmlDiagnosticData |
Fournit les données XML sans séquence d'échappement pour l'enregistrement de données de trace fournies par l'utilisateur. |
UnreachableException |
Exception levée lorsque le programme exécute une instruction qui était considérée comme inaccessible. |
XmlWriterTraceListener |
Dirige la sortie de traçage ou de débogage sous la forme de données encodées XML vers TextWriter ou Stream, telle que FileStream. |
Structures
Activity.Enumerator<T> |
Énumère les données stockées sur un Activity objet . |
ActivityChangedEventArgs |
Fournit des données pour l'événement CurrentChanged. |
ActivityContext |
Représentation conforme à la spécification TraceContext du W3C. Il contient deux identificateurs : un TraceId et un SpanId, ainsi qu’un ensemble de valeurs TraceFlags courantes et TraceState spécifiques au système. |
ActivityCreationOptions<T> |
Encapsule toutes les informations envoyées à l’écouteur d’activité, pour prendre des décisions concernant la création de l’instance d’activité ainsi que sur son état. Les paramètres de type générique possibles sont ActivityContext ou String. |
ActivityEvent |
Représente un événement contenant un nom et un horodatage, ainsi qu’une liste facultative de balises. |
ActivityLink |
Les activités peuvent être liées à zéro ou plusieurs instances de contexte d’activité ayant un lien de causalité. Les liens d’activité peuvent pointer vers des contextes d’activité à l’intérieur d’une seule trace ou sur des traces différentes. Les liens d’activité peuvent être utilisés pour représenter des opérations par lots où une activité a été lancée par plusieurs activités de lancement, chacune représentant un seul élément entrant traité dans le lot. |
ActivitySpanId |
Représente un SpanId mis en forme selon une norme W3C. |
ActivityTagsCollection.Enumerator |
Énumère les éléments d'un |
ActivityTraceId |
Représente un TraceId dont le format est basé sur un standard W3C. |
CounterSample |
Définit une structure qui contient les données brutes d'un compteur de performance. |
Debug.AssertInterpolatedStringHandler |
Fournit un gestionnaire de chaîne interpolé pour Assert(Boolean) qui effectue uniquement la mise en forme en cas d’échec de l’assertion. |
Debug.WriteIfInterpolatedStringHandler |
Fournit un gestionnaire de chaîne interpolé pour WriteIf(Boolean, String) et WriteLineIf(Boolean, Object) qui effectue la mise en forme uniquement si la condition s’applique. |
TagList |
Représente une liste d’étiquettes accessibles par index. Fournit des méthodes de recherche, de tri et de manipulation de listes. |
TagList.Enumerator |
Énumérateur permettant de parcourir une collection de listes de balises. |
Interfaces
ICollectData |
Prépare les données de performance pour la DLL de performance que le système charge lorsqu'il travaille avec les compteurs de performance. |
Énumérations
ActivityIdFormat |
Spécifie le format de la propriété Id. |
ActivityKind |
Décrit la relation entre l’activité, ses parents et ses enfants dans une trace. |
ActivitySamplingResult |
Valeurs d’énumération utilisées par ActivityListener pour indiquer la quantité de données à collecter pour le Activity associé. Le fait de demander plus de données accroît la surcharge, ce qui réduit les performances. |
ActivityStatusCode |
Définissez le code status de l’activité qui indique la status de l’opération instrumentée. |
ActivityTraceFlags |
Spécifie des indicateurs définis par le standard W3C qui sont associés à une activité. |
DebuggableAttribute.DebuggingModes |
Spécifie le mode de débogage pour le compilateur juste-à-temps (JIT). |
DebuggerBrowsableState |
Fournit des instructions d'affichage pour le débogueur. |
EventLogEntryType |
Spécifie le type d'événement d'une entrée du journal des événements. |
EventLogPermissionAccess |
Définit les niveaux d'accès employés par les classes d'autorisation EventLog. |
OverflowAction |
Spécifie comment gérer des entrées dans un journal des événements qui a atteint sa taille maximale. |
PerformanceCounterCategoryType |
Indique si la catégorie du compteur de performance peut avoir plusieurs instances. |
PerformanceCounterInstanceLifetime |
Spécifie la durée de vie d'une instance de compteur de performance. |
PerformanceCounterPermissionAccess |
Définit les niveaux d'accès employés par les classes d'autorisation PerformanceCounter. |
PerformanceCounterType |
Spécifie les types de compteurs de performance qui sont directement mappés à des types natifs. |
PresentationTraceLevel |
Décrit le niveau de détail de traçage relatif à un objet particulier. |
ProcessPriorityClass |
Indique la priorité associée par le système à un processus. Cette valeur, ainsi que la valeur de priorité de chaque thread du processus, déterminent le niveau de priorité de base de chaque thread. |
ProcessWindowStyle |
Spécifie la manière dont une nouvelle fenêtre doit s'afficher lorsque le système démarre un processus. |
SourceLevels |
Spécifie les niveaux des messages de trace filtrés par le commutateur source et le filtre de type d'événement. |
ThreadPriorityLevel |
Spécifie le niveau de priorité d'un thread. |
ThreadState |
Spécifie l'état d'exécution actuel du thread. |
ThreadWaitReason |
Spécifie la raison pour laquelle un thread attend. |
TraceEventType |
Identifie le type d'événement qui a provoqué la trace. |
TraceLevel |
Spécifie les messages à envoyer en sortie pour les classes Debug, Trace et TraceSwitch. |
TraceLogRetentionOption |
Spécifie la structure de fichiers utilisée pour le journal EventSchemaTraceListener. |
TraceOptions |
Spécifie des options de données de trace à écrire dans la sortie de trace. |
Délégués
DataReceivedEventHandler |
Représente la méthode qui gérera l'événement OutputDataReceived ou l'événement ErrorDataReceived de Process. |
DistributedContextPropagator.PropagatorGetterCallback |
Représente la méthode de rappel utilisée dans les méthodes d’extraction des propagateurs. Le rappel est appelé pour rechercher la valeur d’un champ nommé. |
DistributedContextPropagator.PropagatorSetterCallback |
Représente la méthode de rappel utilisée dans les méthodes d’injection des propagateurs. Ce rappel est appelé pour définir la valeur d’un champ nommé. Les propagateurs peuvent l’appeler plusieurs fois pour définir plusieurs champs. |
EntryWrittenEventHandler |
Représente la méthode qui gérera l’événement EntryWritten d’un EventLog. |
SampleActivity<T> |
Délégué qui définit la signature des rappels de ActivityListener utilisés dans le processus d’échantillonnage. |
Remarques
Le EventLog composant fournit des fonctionnalités pour écrire dans les journaux des événements, lire les entrées du journal des événements et créer et supprimer des journaux d’événements et des sources d’événements sur le réseau. Le EntryWrittenEventHandler fournit un moyen d’interagir avec les journaux des événements de manière asynchrone. Les classes connexes permettent d’accéder à un contrôle plus détaillé, notamment les restrictions d’autorisation, la possibilité de spécifier des types de journal des événements (qui contrôle le type de données par défaut écrites avec une entrée de journal des événements) et d’itérer dans les collections d’entrées du journal des événements. Pour plus d’informations sur ces tâches, consultez les EventLogPermissionclasses , EventLogEntryTypeet EventLogEntryCollection .
La Process classe fournit des fonctionnalités permettant de surveiller les processus système sur le réseau, ainsi que de démarrer et d’arrêter les processus système locaux. En plus de récupérer des listes de processus en cours d’exécution (en spécifiant l’ordinateur, le nom du processus ou l’ID de processus) ou d’afficher des informations sur le processus qui a actuellement accès au processeur, vous pouvez obtenir des connaissances détaillées des threads et modules de processus à la fois par le biais de la Process classe elle-même et en interagissant avec les ProcessThread classes et .ProcessModule La ProcessStartInfo classe vous permet de spécifier divers éléments avec lesquels démarrer un nouveau processus, tels que les flux d’entrée, de sortie et d’erreur, les répertoires de travail et les verbes et arguments de ligne de commande. Cela vous donne un contrôle précis sur le comportement de vos processus. D’autres classes associées vous permettent de spécifier des styles de fenêtre, des priorités de processus et de threads, et d’interagir avec des collections de threads et de modules.
La PerformanceCounter classe vous permet de surveiller les performances du système, tandis que la PerformanceCounterCategory classe fournit un moyen de créer de nouveaux compteurs et catégories personnalisés. Vous pouvez écrire dans des compteurs personnalisés locaux et lire à partir des compteurs locaux et distants (système et personnalisé). Vous pouvez échantillonner des compteurs à l’aide de la PerformanceCounter classe et calculer les résultats à partir d’exemples de compteurs de performances successifs à l’aide de la CounterSample classe . La CounterCreationData classe vous permet de créer plusieurs compteurs dans une catégorie et de spécifier leurs types. D’autres classes associées au composant compteur de performances permettent d’accéder à des collections de compteurs, d’autorisations de compteur et de types de compteurs.
L’espace System.Diagnostics de noms fournit également des classes qui vous permettent de déboguer votre application et de suivre l’exécution de votre code. Pour plus d'informations, consultez la classe Trace et Debug.
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour