Compartir a través de


System.Diagnostics Espacio de nombres

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:

  • Los elementos de la colección se ordenarán según cómo se agreguen.
  • No permita la duplicación de elementos con la misma clave.
  • Al usar el indexador para almacenar un elemento en la colección:
    • Si el elemento tiene una clave que existía anteriormente en la colección y el valor es null, el elemento de colección que coincide con la clave se quitará de la colección.
    • Si el elemento tiene una clave que existía anteriormente en la colección y el valor no es null, el nuevo valor de elemento reemplazará el valor anterior almacenado en la colección.
    • De lo contrario, el elemento se agregará a la colección.
  • Agregar método agregará un nuevo elemento a la colección si aún no existe un elemento con la misma clave. De lo contrario, producirá una excepción.
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 TraceSource.Initializing.

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 abstract para los agentes de escucha que supervisan la salida de seguimiento y depuración.

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 ActivityTagsCollection.

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.