System.Diagnostics Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona clases que permiten interactuar con procesos del sistema, registros de eventos y contadores de rendimiento.
Clases
Activity |
Representa una operación con contexto que se va a usar para el registro. |
ActivityListener |
Permite escuchar los eventos de inicio y detención de la actividad y ofrece la oportunidad de decidir la creación de una actividad para escenarios de muestreo. |
ActivitySource |
Proporciona API para crear e iniciar Activity objetos y registrar objetos ActivityListener para escuchar los eventos de Activity. |
ActivityTagsCollection |
ActivityTagsCollection es una clase de colección que se usa para almacenar etiquetas de seguimiento. Esta colección se usará con clases como ActivityEvent y ActivityLink. Esta colección se comporta de la siguiente manera:
|
BooleanSwitch |
Proporciona un conmutador de encendido y apagado sencillo que controla la depuración y la salida de seguimiento. |
ConditionalAttribute |
Indica a los compiladores que se debe omitir una llamada de método o atributo a menos que se defina un símbolo de compilación condicional especificado. |
ConsoleTraceListener |
Dirige el seguimiento o la salida de depuración a la salida estándar o al flujo de error estándar. |
CorrelationManager |
Correlaciona los seguimientos que forman parte de una transacción lógica. |
CounterCreationData |
Define el tipo de contador, el nombre y la cadena de ayuda de un contador personalizado. |
CounterCreationDataCollection |
Proporciona una colección fuertemente tipada de objetos CounterCreationData. |
CounterSampleCalculator |
Proporciona un conjunto de funciones de utilidad para interpretar los datos del contador de rendimiento. |
DataReceivedEventArgs |
Proporciona datos para los eventos OutputDataReceived y ErrorDataReceived. |
Debug |
Proporciona un conjunto de métodos y propiedades que ayudan a depurar el código. |
DebuggableAttribute |
Modifica la generación de código para la depuración Just-In-Time (JIT) en tiempo de ejecución. Esta clase no se puede heredar. |
Debugger |
Habilita la comunicación con un depurador. Esta clase no se puede heredar. |
DebuggerBrowsableAttribute |
Determina si y cómo se muestra un miembro en las ventanas de variables del depurador. Esta clase no se puede heredar. |
DebuggerDisableUserUnhandledExceptionsAttribute |
Si se adjunta un depurador de .NET que admite la API de BreakForUserUnhandledException(Exception), el depurador no interrumpirá las excepciones no controladas por el usuario cuando se detecte la excepción mediante un método con este atributo, a menos que se llame a BreakForUserUnhandledException(Exception). |
DebuggerDisplayAttribute |
Determina cómo se muestra una clase o campo en las ventanas de variables del depurador. |
DebuggerHiddenAttribute |
Especifica el DebuggerHiddenAttribute. Esta clase no se puede heredar. |
DebuggerNonUserCodeAttribute |
Identifica un tipo o miembro que no forma parte del código de usuario de una aplicación. |
DebuggerStepperBoundaryAttribute |
Indica que el código que sigue al atributo se va a ejecutar en modo de ejecución, no paso. |
DebuggerStepThroughAttribute |
Indica al depurador que recorra el código en lugar de pasar por el código. Esta clase no se puede heredar. |
DebuggerTypeProxyAttribute |
Especifica el proxy de presentación de un tipo. |
DebuggerVisualizerAttribute |
Especifica que el tipo tiene un visualizador. Esta clase no se puede heredar. |
DefaultTraceListener |
Proporciona los métodos de salida y el comportamiento predeterminados para el seguimiento. |
DelimitedListTraceListener |
Dirige la salida de seguimiento o depuración a un escritor de texto, como un sistema de escritura de secuencias o a una secuencia, como una secuencia de archivos. |
DiagnosticListener |
Proporciona una implementación de la clase abstracta DiagnosticSource que representa un lugar con nombre al que un origen envía su información (eventos). |
DiagnosticListenerExtensions |
Proporciona clases que permiten interactuar con procesos del sistema, registros de eventos y contadores de rendimiento. |
DiagnosticMethodInfo |
Representa información de diagnóstico sobre un método. La información proporcionada por esta clase es similar a la información proporcionado por MethodBase, pero está pensado para fines de registro y seguimiento. |
DiagnosticsConfigurationHandler |
Controla la sección de diagnóstico de los archivos de configuración. |
DiagnosticSource |
Clase abstracta que permite instrumentar el código para el registro en tiempo de producción de cargas de datos enriquecidas para su consumo dentro del proceso instrumentado. |
DistributedContextPropagator |
Una implementación de DistributedContextPropagator determina si y cómo se codifica y descodifica la información de contexto distribuida a medida que atraviesa la red. La codificación se puede transportar a través de cualquier protocolo de red que admita pares clave-valor de cadena. Por ejemplo, al usar HTTP, cada par clave-valor es un encabezado HTTP. DistributedContextPropagator inserta valores en y extrae valores de operadores como pares clave-valor de cadena. |
EntryWrittenEventArgs |
Proporciona datos para el evento EntryWritten. |
EventInstance |
Representa información independiente del idioma para una entrada del registro de eventos. |
EventLog |
Proporciona interacción con los registros de eventos de Windows. |
EventLogEntry |
Encapsula un único registro en el registro de eventos. Esta clase no se puede heredar. |
EventLogEntryCollection |
Define el tamaño y los enumeradores para una colección de instancias de EventLogEntry. |
EventLogInstaller |
Permite instalar y configurar un registro de eventos en el que la aplicación lee o escribe cuando se ejecuta. |
EventLogPermission |
Controla los permisos de acceso de código para el registro de eventos. |
EventLogPermissionAttribute |
Permite comprobaciones de permisos declarativos para el registro de eventos. |
EventLogPermissionEntry |
Define la unidad más pequeña de un permiso de seguridad de acceso de código establecido para un EventLog. |
EventLogPermissionEntryCollection |
Contiene una colección fuertemente tipada de objetos EventLogPermissionEntry. |
EventLogTraceListener |
Proporciona un agente de escucha sencillo que dirige la salida de seguimiento o depuración a un EventLog. |
EventSchemaTraceListener |
Dirige la salida de seguimiento o depuración de eventos de un extremo a otro a un archivo de registro codificado con XML y compatible con el esquema. |
EventSourceCreationData |
Representa las opciones de configuración usadas para crear un origen de registro de eventos en el equipo local o en un equipo remoto. |
EventTypeFilter |
Indica si un agente de escucha debe realizar un seguimiento en función del tipo de evento. |
FileVersionInfo |
Proporciona información de versión para un archivo físico en el disco. |
InitializingSwitchEventArgs |
Proporciona datos para el evento switch.Initializing |
InitializingTraceSourceEventArgs |
Proporciona datos para el evento |
InstanceData |
Contiene datos de instancia asociados a un ejemplo de contador de rendimiento. |
InstanceDataCollection |
Proporciona una colección fuertemente tipada de objetos InstanceData. |
InstanceDataCollectionCollection |
Proporciona una colección fuertemente tipada de objetos InstanceDataCollection. |
MonitoringDescriptionAttribute |
Especifica una descripción de una propiedad o evento. |
PerformanceCounter |
Representa un componente de contador de rendimiento de Windows NT. |
PerformanceCounterCategory |
Representa un objeto de rendimiento, que define una categoría de contadores de rendimiento. |
PerformanceCounterInstaller |
Especifica un instalador para el componente PerformanceCounter. |
PerformanceCounterManager |
Prepara los datos de rendimiento para el performance.dll el sistema se carga al trabajar con contadores de rendimiento. |
PerformanceCounterPermission |
Permite el control de los permisos de acceso de código para PerformanceCounter. |
PerformanceCounterPermissionAttribute |
Permite comprobaciones de permisos de contador de rendimiento declarativos. |
PerformanceCounterPermissionEntry |
Define la unidad más pequeña de un permiso de seguridad de acceso de código establecido para un PerformanceCounter. |
PerformanceCounterPermissionEntryCollection |
Contiene una colección fuertemente tipada de objetos PerformanceCounterPermissionEntry. |
PresentationTraceSources |
Proporciona compatibilidad con el seguimiento de depuración destinada específicamente a aplicaciones de Windows Presentation Foundation (WPF). |
Process |
Proporciona acceso a procesos locales y remotos y le permite iniciar y detener los procesos del sistema local. |
ProcessModule |
Representa un archivo .dll o .exe que se carga en un proceso determinado. |
ProcessModuleCollection |
Proporciona una colección fuertemente tipada de objetos ProcessModule. |
ProcessStartInfo |
Especifica un conjunto de valores que se usan al iniciar un proceso. |
ProcessThread |
Representa un subproceso de proceso del sistema operativo. |
ProcessThreadCollection |
Proporciona una colección fuertemente tipada de objetos ProcessThread. |
SourceFilter |
Indica si un agente de escucha debe realizar un seguimiento de un mensaje basado en el origen de un seguimiento. |
SourceSwitch |
Proporciona un modificador de varios niveles para controlar el seguimiento y depurar la salida sin volver a compilar el código. |
StackFrame |
Proporciona información sobre un StackFrame, que representa una llamada de función en la pila de llamadas para el subproceso actual. |
StackFrameExtensions |
Proporciona métodos de extensión para la clase StackFrame, que representa una llamada de función en la pila de llamadas para el subproceso actual. |
StackTrace |
Representa un seguimiento de pila, que es una colección ordenada de uno o varios marcos de pila. |
StackTraceHiddenAttribute |
Los tipos y métodos con atributos stackTraceHidden se omitirán del texto de seguimiento de pila que se muestra en StackTrace.ToString() y Exception.StackTrace |
Stopwatch |
Proporciona un conjunto de métodos y propiedades que puede usar para medir con precisión el tiempo transcurrido. |
Switch |
Proporciona una clase base abstracta para crear nuevos modificadores de depuración y seguimiento. |
SwitchAttribute |
Identifica un modificador usado en un ensamblado, una clase o un miembro. |
SwitchLevelAttribute |
Identifica el tipo de nivel de un modificador. |
TextWriterTraceListener |
Dirige la salida de seguimiento o depuración a un TextWriter o a un Stream, como FileStream. |
Trace |
Proporciona un conjunto de métodos y propiedades que le ayudan a realizar un seguimiento de la ejecución del código. Esta clase no se puede heredar. |
TraceConfiguration |
Proporciona clases que permiten interactuar con procesos del sistema, registros de eventos y contadores de rendimiento. |
TraceEventCache |
Proporciona datos de eventos de seguimiento específicos de un subproceso y un proceso. |
TraceFilter |
Proporciona la clase base para las implementaciones de filtro de seguimiento. |
TraceListener |
Proporciona la clase base |
TraceListenerCollection |
Proporciona una lista segura para subprocesos de objetos TraceListener. |
TraceSource |
Proporciona un conjunto de métodos y propiedades que permiten a las aplicaciones realizar un seguimiento de la ejecución del código y asociar mensajes de seguimiento a su origen. |
TraceSwitch |
Proporciona un modificador de varios niveles para controlar el seguimiento y depurar la salida sin volver a compilar el código. |
UnescapedXmlDiagnosticData |
Proporciona datos XML sin escape para el registro de datos de seguimiento proporcionados por el usuario. |
UnreachableException |
Excepción que se produce cuando el programa ejecuta una instrucción que se pensó que era inaccesible. |
XmlWriterTraceListener |
Dirige la salida de seguimiento o depuración como datos codificados con XML a un TextWriter o a un Stream, como un FileStream. |
Estructuras
Activity.Enumerator<T> |
Enumera los datos almacenados en un objeto Activity. |
ActivityChangedEventArgs |
Proporciona datos para el evento CurrentChanged. |
ActivityContext |
Representación que se ajusta a la especificación TraceContext de W3C. Contiene dos identificadores: TraceId y SpanId, junto con un conjunto de valores TraceFlags comunes y TraceState específicos del sistema. |
ActivityCreationOptions<T> |
Encapsula toda la información que se envía al agente de escucha de actividad para tomar decisiones sobre la creación de la instancia de actividad, así como su estado. Los posibles parámetros de tipo genérico son ActivityContext o String. |
ActivityEvent |
Representa un evento que contiene un nombre y una marca de tiempo, así como una lista opcional de etiquetas. |
ActivityLink |
Las actividades pueden estar vinculadas a cero o más instancias de contexto de actividad que están relacionadas causalmente. Los vínculos de actividad pueden apuntar a contextos de actividad dentro de un único seguimiento o a través de diferentes seguimientos. Los vínculos de actividad se pueden usar para representar operaciones por lotes en las que se inició una actividad mediante varias actividades iniciadas, cada una de las cuales representa un único elemento entrante que se está procesando en el lote. |
ActivitySpanId |
Representa un SpanId con formato basado en un estándar W3C. |
ActivityTagsCollection.Enumerator |
Enumera los elementos de un |
ActivityTraceId |
Representa un TraceId cuyo formato se basa en un estándar W3C. |
CounterSample |
Define una estructura que contiene los datos sin procesar de un contador de rendimiento. |
Debug.AssertInterpolatedStringHandler |
Proporciona un controlador de cadenas interpolado para Assert(Boolean) que solo realiza el formato si se produce un error en la aserción. |
Debug.WriteIfInterpolatedStringHandler |
Proporciona un controlador de cadenas interpolado para WriteIf(Boolean, String) y WriteLineIf(Boolean, Object) que solo realiza el formato si se aplica la condición. |
TagList |
Representa una lista de etiquetas a las que puede acceder el índice. Proporciona métodos para buscar, ordenar y manipular listas. |
TagList.Enumerator |
Enumerador para recorrer una colección de listas de etiquetas. |
Interfaces
ICollectData |
Prepara los datos de rendimiento para el archivo DLL de rendimiento que el sistema carga al trabajar con contadores de rendimiento. |
Enumeraciones
ActivityIdFormat |
Especifica el formato de la propiedad Id. |
ActivityKind |
Describe la relación entre la actividad, sus elementos primarios y sus elementos secundarios en un seguimiento. |
ActivitySamplingResult |
Valores de enumeración usados por ActivityListener para indicar la cantidad de datos que se van a recopilar para el Activityrelacionado. La solicitud de más datos provoca una mayor sobrecarga de rendimiento. |
ActivityStatusCode |
Defina el código de estado de la actividad que indica el estado de la operación instrumentada. |
ActivityTraceFlags |
Especifica marcas definidas por el estándar W3C que están asociados a una actividad. |
DebuggableAttribute.DebuggingModes |
Especifica el modo de depuración para el compilador Just-In-Time (JIT). |
DebuggerBrowsableState |
Proporciona instrucciones para mostrar para el depurador. |
EventLogEntryType |
Especifica el tipo de evento de una entrada de registro de eventos. |
EventLogPermissionAccess |
Define los niveles de acceso utilizados por EventLog clases de permisos. |
OverflowAction |
Especifica cómo controlar las entradas de un registro de eventos que ha alcanzado su tamaño máximo de archivo. |
PerformanceCounterCategoryType |
Indica si la categoría del contador de rendimiento puede tener varias instancias. |
PerformanceCounterInstanceLifetime |
Especifica la duración de una instancia de contador de rendimiento. |
PerformanceCounterPermissionAccess |
Define los niveles de acceso utilizados por PerformanceCounter clases de permisos. |
PerformanceCounterType |
Especifica los tipos de contador de rendimiento que se asignan directamente a los tipos nativos. |
PresentationTraceLevel |
Describe el nivel de detalle para realizar un seguimiento de un objeto determinado. |
ProcessPriorityClass |
Indica la prioridad que el sistema asocia a un proceso. Este valor, junto con el valor de prioridad de cada subproceso del proceso, determina el nivel de prioridad base de cada subproceso. |
ProcessWindowStyle |
Se especificó cómo debería aparecer una nueva ventana cuando el sistema inicia un proceso. |
SourceLevels |
Especifica los niveles de mensajes de seguimiento filtrados por el modificador de origen y el filtro de tipo de evento. |
ThreadPriorityLevel |
Especifica el nivel de prioridad de un subproceso. |
ThreadState |
Especifica el estado de ejecución actual del subproceso. |
ThreadWaitReason |
Especifica el motivo por el que un subproceso está esperando. |
TraceEventType |
Identifica el tipo de evento que ha causado el seguimiento. |
TraceLevel |
Especifica los mensajes que se van a generar para las clases Debug, Trace y TraceSwitch. |
TraceLogRetentionOption |
Especifica la estructura de archivos que se usará para el registro de EventSchemaTraceListener. |
TraceOptions |
Especifica las opciones de datos de seguimiento que se van a escribir en la salida del seguimiento. |
Delegados
DataReceivedEventHandler |
Representa el método que controlará el evento OutputDataReceived o ErrorDataReceived evento de un Process. |
DistributedContextPropagator.PropagatorGetterCallback |
Representa el método de devolución de llamada que se usa en los métodos de extracción de propagadores. La devolución de llamada se invoca para buscar el valor de un campo con nombre. |
DistributedContextPropagator.PropagatorSetterCallback |
Representa el método de devolución de llamada que se usa en los métodos de inserción de propagadores. Esta devolución de llamada se invoca para establecer el valor de un campo con nombre. Los propagadores pueden invocarlo varias veces para establecer varios campos. |
EntryWrittenEventHandler |
Representa el método que controlará el evento EntryWritten de un EventLog. |
ExceptionRecorder |
Proporciona clases que permiten interactuar con procesos del sistema, registros de eventos y contadores de rendimiento. |
SampleActivity<T> |
Delegado que define la firma de los ActivityListener devoluciones de llamada usadas en el proceso de muestreo. |
Comentarios
El componente EventLog proporciona funcionalidad para escribir en registros de eventos, leer entradas del registro de eventos y crear y eliminar registros de eventos y orígenes de eventos en la red. El EntryWrittenEventHandler proporciona una manera de interactuar con los registros de eventos de forma asincrónica. Las clases auxiliares proporcionan acceso a un control más detallado, incluidas: restricciones de permisos, la capacidad de especificar tipos de registro de eventos (que controlan el tipo de datos predeterminados que se escriben con una entrada del registro de eventos) e iteran a través de colecciones de entradas del registro de eventos. Para obtener más información sobre estas tareas, vea las clases EventLogPermission, EventLogEntryTypey EventLogEntryCollection.
La clase Process proporciona funcionalidad para supervisar los procesos del sistema a través de la red y para iniciar y detener los procesos del sistema local. Además de recuperar listas de procesos en ejecución (especificando el equipo, el nombre del proceso o el identificador de proceso) o viendo información sobre el proceso que actualmente tiene acceso al procesador, puede obtener conocimientos detallados sobre los subprocesos de proceso y módulos tanto a través de la propia clase Process como mediante la interacción con las clases ProcessThread y ProcessModule. La clase ProcessStartInfo permite especificar una variedad de elementos con los que iniciar un nuevo proceso, como flujos de entrada, salida y errores, directorios de trabajo y verbos y argumentos de línea de comandos. Estos proporcionan un control preciso sobre el comportamiento de los procesos. Otras clases relacionadas permiten especificar estilos de ventana, prioridades de procesos y subprocesos e interactuar con colecciones de subprocesos y módulos.
La clase PerformanceCounter permite supervisar el rendimiento del sistema, mientras que la clase PerformanceCounterCategory proporciona una manera de crear nuevos contadores y categorías personalizados. Puede escribir en contadores personalizados locales y leer desde contadores locales y remotos (sistema, así como personalizados). Puede muestrear contadores mediante la clase PerformanceCounter y calcular los resultados de ejemplos sucesivos de contadores de rendimiento mediante la clase CounterSample. La clase CounterCreationData permite crear varios contadores en una categoría y especificar sus tipos. Otras clases asociadas al componente de contador de rendimiento proporcionan acceso a colecciones de contadores, permisos de contador y tipos de contadores.
El System.Diagnostics espacio de nombres también proporciona clases que permiten depurar la aplicación y realizar un seguimiento de la ejecución del código. Para obtener más información, consulte las clases Trace y Debug.