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 los procesos del sistema, registros de eventos y contadores de rendimiento.
Clases
Activity |
Representa una operación con el contexto que se usará para el registro. |
ActivityListener |
Permite escuchar los eventos de actividad de inicio y detención y brinda la oportunidad de decidir la creación de una actividad para los escenarios de muestreo. |
ActivitySource |
Proporciona las API para crear e iniciar objetos Activity, así como para registrar objetos ActivityListener, a fin de 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 activado/desactivado sencillo que controla los resultados de depuración y traza. |
ConditionalAttribute |
Indica a los compiladores que se debe omitir una llamada al método o un atributo a menos que se defina un símbolo de compilación condicional especificado. |
ConsoleTraceListener |
Dirige el resultado de la traza o la depuración a la salida estándar o a la secuencia de error estándar. |
CorrelationManager |
Establece una correlación entre 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 puede heredarse. |
Debugger |
Permite la comunicación con un depurador. Esta clase no puede heredarse. |
DebuggerBrowsableAttribute |
Determina si se muestra un miembro en las ventanas de variables del depurador y cómo se muestra. Esta clase no puede heredarse. |
DebuggerDisplayAttribute |
Determina cómo se muestran una clase o un campo en las ventanas de variables del depurador. |
DebuggerHiddenAttribute |
Especifica el DebuggerHiddenAttribute. Esta clase no puede heredarse. |
DebuggerNonUserCodeAttribute |
Identifica un tipo o un miembro que no forman parte del código de usuario de una aplicación. |
DebuggerStepperBoundaryAttribute |
Indica que el código después del atributo debe ejecutarse en modo de ejecución y no en modo paso a paso. |
DebuggerStepThroughAttribute |
Indica al depurador que recorra el código en lugar de ejecutarlo paso a paso. Esta clase no puede heredarse. |
DebuggerTypeProxyAttribute |
Especifica el proxy de presentación para un tipo. |
DebuggerVisualizerAttribute |
Especifica que el tipo tiene un visualizador. Esta clase no puede heredarse. |
DefaultTraceListener |
Proporciona los métodos de salida predeterminados y el comportamiento para el seguimiento. |
DelimitedListTraceListener |
Dirige los resultados de traza o de depuración a un escritor de texto, como un escritor de secuencias, o a una secuencia, como una secuencia de archivo. |
DiagnosticListener |
Proporciona una implementación de la clase abstracta DiagnosticSource que representa una ubicación con nombre a la que un origen envía su información (eventos). |
DiagnosticListenerExtensions |
Proporciona clases que permiten interactuar con los procesos del sistema, registros de eventos y contadores de rendimiento. |
DiagnosticsConfigurationHandler |
Controla la sección de diagnósticos de archivos de configuración. |
DiagnosticSource |
Clase abstracta que permite instrumentar el código para el registro de tiempo de producción de las cargas de datos enriquecidos para su uso dentro del proceso que se ha 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 mediante cualquier protocolo de red que admita pares clave-valor de cadena. Por ejemplo, cuando se usa 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 la información independiente del idioma de 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 puede heredarse. |
EventLogEntryCollection |
Define el tamaño y los enumeradores de 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 al código para el registro de eventos. |
EventLogPermissionAttribute |
Permite realizar comprobaciones declarativas de permisos para registros de eventos. |
EventLogPermissionEntry |
Define la unidad más pequeña de un permiso de seguridad de acceso del código que se establece para EventLog. |
EventLogPermissionEntryCollection |
Contiene una colección fuertemente tipada de objetos EventLogPermissionEntry. |
EventLogTraceListener |
Proporciona un agente de escucha simple que dirige el resultado de la traza o la depuración a EventLog. |
EventSchemaTraceListener |
Dirige los resultados de seguimiento o de depuración de eventos de un extremo a otro a un archivo de registro con codificación XML conforme al esquema. |
EventSourceCreationData |
Representa los valores de configuración utilizados para crear un origen de registro de eventos en el equipo local o un equipo remoto. |
EventTypeFilter |
Indica si un agente de escucha debe realizar el seguimiento basándose en el tipo de evento. |
FileVersionInfo |
Proporciona información de versión para un archivo físico en disco. |
InitializingSwitchEventArgs |
Proporciona datos para el evento Switch.Initializing . |
InitializingTraceSourceEventArgs |
Proporciona datos para el evento TraceSource.Initializing . |
InstanceData |
Contiene los datos de instancia asociados a un contador de rendimiento de ejemplo. |
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 para 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 archivo performance.dll que carga el sistema al trabajar con contadores de rendimiento. |
PerformanceCounterPermission |
Permite controlar los permisos de acceso al código para PerformanceCounter. |
PerformanceCounterPermissionAttribute |
Permite comprobaciones declarativas de permiso de contador de rendimiento. |
PerformanceCounterPermissionEntry |
Define la unidad más pequeña de un permiso de seguridad de acceso del código que se establece para PerformanceCounter. |
PerformanceCounterPermissionEntryCollection |
Contiene una colección fuertemente tipada de objetos PerformanceCounterPermissionEntry. |
PresentationTraceSources |
Ofrece compatibilidad de traza de depuración que está específicamente destinada para aplicaciones de Windows Presentation Foundation (WPF). |
Process |
Proporciona acceso a procesos locales y remotos, y permite iniciar y detener 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 usa cuando se inicia un proceso. |
ProcessThread |
Representa un subproceso del sistema operativo. |
ProcessThreadCollection |
Proporciona una colección fuertemente tipada de objetos ProcessThread. |
SourceFilter |
Indica si un agente de escucha debe realizar el seguimiento de un mensaje basándose en el origen de un seguimiento. |
SourceSwitch |
Proporciona un modificador multinivel para controlar la generación de traza y depuración sin recompilar su código. |
StackFrame |
Proporciona información sobre un StackFrame, que representa una llamada de función en la pila de llamadas del 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 del subproceso actual. |
StackTrace |
Representa un seguimiento de pila, que es una colección ordenada de uno o más marcos de pila. |
StackTraceHiddenAttribute |
Los tipos y métodos con atributos StackTraceHidden se omitirán en el texto de seguimiento de la pila que se muestra en StackTrace.ToString() y Exception.StackTrace. |
Stopwatch |
Proporciona un conjunto de métodos y propiedades que puede usar para medir el tiempo transcurrido con precisión. |
Switch |
Proporciona una clase base abstracta para crear nuevos modificadores de depuración y traza. |
SwitchAttribute |
Identifica un modificador utilizado en un ensamblado, una clase o un miembro. |
SwitchLevelAttribute |
Identifica el tipo de nivel de un modificador. |
TextWriterTraceListener |
Dirige los resultados de la traza o la depuración a un objeto TextWriter o a un objeto de la clase Stream como un archivo FileStream. |
Trace |
Proporciona un conjunto de métodos y propiedades que ayudan a realizar un seguimiento del código. Esta clase no puede heredarse. |
TraceConfiguration |
Proporciona clases que permiten interactuar con los procesos del sistema, registros de eventos y contadores de rendimiento. |
TraceEventCache |
Proporciona los datos de evento de seguimiento específicos de un subproceso y un proceso. |
TraceFilter |
Proporciona la clase base para las implementaciones de los filtros de seguimiento. |
TraceListener |
Proporciona la clase base |
TraceListenerCollection |
Proporciona una lista de objetos TraceListener segura para subprocesos. |
TraceSource |
Proporciona un conjunto de métodos y propiedades que permiten que las aplicaciones realicen un seguimiento de la ejecución de código y asocien mensajes de seguimiento con su origen. |
TraceSwitch |
Proporciona un modificador multinivel para controlar la generación de traza y depuración sin recompilar su código. |
UnescapedXmlDiagnosticData |
Proporciona datos XML sin escape para el registro de la información de seguimiento proporcionada por el usuario. |
UnreachableException |
Excepción que se produce cuando el programa ejecuta una instrucción a la que se pensaba que no se iba a llegar. |
XmlWriterTraceListener |
Dirige los resultados de traza o de depuración como datos en código XML a un TextWriter o a una Stream, como una FileStream. |
Estructuras
Activity.Enumerator<T> |
Enumera los datos almacenados en un Activity objeto . |
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 cliente de escucha de actividad para tomar decisiones sobre la creación de la instancia de la actividad, así como su estado. Los parámetros de tipo genérico posibles 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 de manera causal. Los vínculos de actividad pueden apuntar a contextos de actividad dentro de un único seguimiento o a través de varios seguimientos. Los vínculos de actividad se pueden utilizar para representar operaciones por lotes en las que varias actividades de inicio iniciaron una actividad, donde cada una de las cuales representa un único elemento entrante que se está procesando en el lote. |
ActivitySpanId |
Representa un elemento SpanId con formato según un estándar W3C. |
ActivityTagsCollection.Enumerator |
Enumera los elementos de un objeto |
ActivityTraceId |
Representa un elemento 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 realice 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 los 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 utilizados por ActivityListener para indicar la cantidad de datos que se van a recopilar para el elemento Activity relacionado. 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 las marcas definidas por el estándar W3C asociadas a una actividad. |
DebuggableAttribute.DebuggingModes |
Especifica el modo de depuración para el compilador Just-In-Time (JIT). |
DebuggerBrowsableState |
Proporciona instrucciones de presentación para el depurador. |
EventLogEntryType |
Especifica el tipo de evento de una entrada del registro de eventos. |
EventLogPermissionAccess |
Define los niveles de acceso utilizados por las clases de permiso EventLog. |
OverflowAction |
Especifica el modo de tratar las entradas de un registro de eventos que ha alcanzado el tamaño de archivo máximo. |
PerformanceCounterCategoryType |
Indica si la categoría de contador de rendimiento puede tener varias instancias. |
PerformanceCounterInstanceLifetime |
Especifica la duración de una instancia del contador de rendimiento. |
PerformanceCounterPermissionAccess |
Define los niveles de acceso utilizados por las clases de permiso PerformanceCounter. |
PerformanceCounterType |
Especifica los tipos de contadores de rendimiento que se asignan directamente a los tipos nativos. |
PresentationTraceLevel |
Describe el nivel de detalle que se va a obtener 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 |
Determinaba cómo debe aparecer una ventana cuando el sistema inicia un proceso. |
SourceLevels |
Especifica los niveles de los 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 la razón por la que el subproceso está esperando. |
TraceEventType |
Identifica el tipo de evento que ha originado el seguimiento. |
TraceLevel |
Especifica qué mensajes se van a enviar para las clases Debug, Trace y TraceSwitch. |
TraceLogRetentionOption |
Especifica la estructura de archivos que se utilizará para el registro de EventSchemaTraceListener. |
TraceOptions |
Especifica las opciones de los datos de seguimiento que se van a escribir en el resultado de seguimiento. |
Delegados
DataReceivedEventHandler |
Representa el método que controlará los eventos OutputDataReceived o ErrorDataReceived 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 EventLog. |
SampleActivity<T> |
Delegado que define la firma de las devoluciones de llamadas de ActivityListener utilizadas en el proceso de muestreo. |
Comentarios
El EventLog componente 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. 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 las 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) y recorrer en iteración las colecciones de entradas del registro de eventos. Para obtener más información sobre estas tareas, vea las EventLogPermissionclases , EventLogEntryTypey EventLogEntryCollection .
La Process clase 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 de los subprocesos y módulos de proceso tanto a través de la propia clase como mediante la Process interacción con las ProcessThread clases y ProcessModule . La ProcessStartInfo clase 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. Esto le proporciona un control preciso sobre el comportamiento de los procesos. Otras clases relacionadas permiten especificar los estilos de ventana, las prioridades de procesos y subprocesos e interactuar con colecciones de subprocesos y módulos.
La PerformanceCounter clase permite supervisar el rendimiento del sistema, mientras que la PerformanceCounterCategory clase proporciona una manera de crear nuevos contadores y categorías personalizados. Puede escribir en los contadores personalizados locales y leer desde los contadores locales y los remotos (del sistema, así como personalizados). Puede muestrear contadores mediante la PerformanceCounter clase y calcular los resultados de muestras de contadores de rendimiento sucesivos mediante la CounterSample clase . La CounterCreationData clase permite crear varios contadores en una categoría y especificar sus tipos. Otras clases asociadas al componente de contadores de rendimiento proporcionan acceso a colecciones de contadores, permisos de contadores 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, vea las clases Trace y Debug.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de