System.Diagnostics 命名空间
.NET Framework 类库


.NET Framework 类库
System.Diagnostics 命名空间

更新:2007 年 11 月

System.Diagnostics 命名空间提供特定的类,使您能够与系统进程、事件日志和性能计数器进行交互。

  • EventLog 组件提供在网络上写入事件日志、读取事件日志项以及创建和删除事件日志与事件源的功能。EntryWrittenEventHandler 提供与事件日志进行异步交互的方式。支持类提供对详细控制的访问,其中包括:权限限制、指定事件日志类型的功能(控制通过事件日志项写入的默认数据的类型)以及循环访问事件日志项集合的功能。有关这些任务的更多信息,请参见 EventLogPermissionEventLogEntryTypeEventLogEntryCollection 类。

  • Process 类提供下列功能:监视整个网络的系统进程以及启动和停止本地系统进程。除了检索运行进程列表(通过指定计算机、进程名称或进程 ID)或查看有关当前可访问处理器的进程的信息之外,还可以获取有关进程线程和模块的详细信息,其方法是通过 Process 类本身,以及分别通过与 ProcessThreadProcessModule 类进行交互来获取。利用 ProcessStartInfo 类,您可以指定用来启动新进程的多种元素,如输入流、输出流、错误流、工作目录以及命令行谓词和参数。它们使您能够对进程的行为进行细微的控制。其他相关类用于指定窗口样式、进程和线程优先级以及与线程和模块的集合进行交互。

  • PerformanceCounter 类使您能够监视系统性能,而 PerformanceCounterCategory 类则提供新建自定义计数器和类别的方式。您可以写入本地自定义计数器和从本地及远程计数器(系统和自定义计数器)中读取。您可以使用 PerformanceCounter 类对计数器进行取样,并使用 CounterSample 类来计算连续性能计数器样本的结果。CounterCreationData 类用于在一个类别中创建多个计数器并指定其类型。与性能计数器组件关联的其他类提供对计数器集合、计数器权限和计数器类型的访问。

System.Diagnostics 命名空间还提供用于调试应用程序和跟踪代码执行情况的类。有关更多信息,请参见 TraceDebug 类。


  说明
BooleanSwitch提供一个简单的开/关开关来控制调试和跟踪输出。
ConditionalAttribute指示编译器应忽略方法调用或属性,除非已定义指定的条件编译符号。
ConsoleTraceListener将跟踪或调试输出定向到标准输出或标准错误流。
CorrelationManager关联同属于某个逻辑事务的多个跟踪。
CounterCreationData定义自定义计数器的计数器类型、名称和帮助字符串。
CounterCreationDataCollection提供 CounterCreationData 对象的强类型集合。
CounterSampleCalculator为解释性能计数器数据提供一组实用工具函数。
DataReceivedEventArgs提供有关 OutputDataReceivedErrorDataReceived 事件的数据。
Debug提供一组帮助调试代码的方法和属性。无法继承此类。
DebuggableAttribute修改运行库实时 (JIT) 调试的代码生成。无法继承此类。
Debugger启用与调试器的通讯。无法继承此类。
DebuggerBrowsableAttribute确定是否在调试器变量窗口中显示成员以及如何显示成员。无法继承此类。
DebuggerDisplayAttribute确定类或字段在调试器的变量窗口中的显示方式。
DebuggerHiddenAttribute指定 DebuggerHiddenAttribute。无法继承此类。
DebuggerNonUserCodeAttribute标识不属于应用程序用户代码的类型或成员。
DebuggerStepperBoundaryAttribute指示属性后面的代码将以运行模式而非单步执行模式执行。
DebuggerStepThroughAttribute指定 DebuggerStepThroughAttribute。无法继承此类。
DebuggerTypeProxyAttribute指定类型的显示代理。
DebuggerVisualizerAttribute指定类型具有可视化工具。无法继承此类。
DefaultTraceListener提供跟踪的默认输出方法和行为。
DelimitedListTraceListener将跟踪或调试输出定向到文本编写器(如流编写器)或流(如文件流)。
DiagnosticsConfigurationHandler基础结构。 已过时。处理配置文件的诊断节。
EntryWrittenEventArgsEntryWritten 事件提供数据。
EventInstance表示事件日志项的非特定语言信息。
EventLog提供与 Windows 事件日志的交互。
EventLogEntry在事件日志中封装单个记录。无法继承此类。
EventLogEntryCollection定义 EventLogEntry 实例集合的大小和枚举数。
EventLogInstaller使您能够安装和配置应用程序在运行时所读取或写入的事件日志。
EventLogPermission允许控制事件日志的代码访问权限。
EventLogPermissionAttribute允许对事件日志进行声明性权限检查。
EventLogPermissionEntry定义为 EventLog 设置的代码访问安全性权限的最小单位。
EventLogPermissionEntryCollection包含 EventLogPermissionEntry 对象的强类型集合。
EventLogTraceListener提供一个简单侦听器,它将跟踪或调试输出指向 EventLog
EventSchemaTraceListener将端对端事件的跟踪或调试输出定向到 XML 编码的符合架构的日志文件。
EventSourceCreationData表示用于在本地或远程计算机上创建事件日志源的配置设置。
EventTypeFilter指示侦听器是否应该基于事件类型进行跟踪。
FileVersionInfo为磁盘上的物理文件提供版本信息。
InstanceData保存与性能计数器样本关联的实例数据。
InstanceDataCollection提供 InstanceData 对象的强类型集合。
InstanceDataCollectionCollection提供 InstanceDataCollection 对象的强类型集合。
MonitoringDescriptionAttribute指定属性或事件的说明。
PerformanceCounter表示 Windows NT 性能计数器组件。
PerformanceCounterCategory表示性能对象,它定义性能计数器的类别。
PerformanceCounterInstaller指定 PerformanceCounter 组件的安装程序。
PerformanceCounterManager基础结构。 已过时。为系统使用性能计数器时加载的 performance.dll 准备性能数据。
PerformanceCounterPermission允许控制 PerformanceCounter 的代码访问权限。
PerformanceCounterPermissionAttribute允许进行声明性能计数器权限检查。
PerformanceCounterPermissionEntry定义为 PerformanceCounter 设置的代码访问安全权限的最小单位。
PerformanceCounterPermissionEntryCollection包含 PerformanceCounterPermissionEntry 对象的强类型集合。
PresentationTraceSources提供专门针对于 Windows Presentation Foundation (WPF) 应用程序的调试跟踪支持。这是一个抽象类。
Process提供对本地和远程进程的访问并使您能够启动和停止本地系统进程。
ProcessModule表示加载到特定进程中的 .dll 或 .exe 文件。
ProcessModuleCollection提供 ProcessModule 对象的强类型集合。
ProcessStartInfo指定启动进程时使用的一组值。
ProcessThread表示操作系统进程线程。
ProcessThreadCollection提供 ProcessThread 对象的强类型集合。
SourceFilter 指示侦听器是否应基于跟踪源跟踪消息。
SourceSwitch提供多级开关控制跟踪和调试输出而不必重新编译代码。
StackFrame提供关于 StackFrame(表示当前线程的调用堆栈中的一个函数调用)的信息。
StackTrace表示一个堆栈跟踪,它是一个或多个堆栈帧的有序集合。
Stopwatch提供一组方法和属性,可用于准确地测量运行时间。
Switch提供一个用于创建新的调试和跟踪开关的抽象基类。
SwitchAttribute标识程序集、类或成员中使用的开关。
SwitchLevelAttribute标识开关的级别类型。
TextWriterTraceListener将跟踪或调试输出定向到 TextWriterStream,如 FileStream
Trace提供一组帮助您跟踪代码执行情况的方法和属性。无法继承此类。
TraceEventCache提供特定于线程和进程的跟踪事件数据。
TraceFilter为跟踪筛选器实现提供基类。
TraceListener 为监视跟踪和调试输出的侦听器提供 abstract 基类。
TraceListenerCollection提供 TraceListener 对象的线程安全列表。
TraceSource提供一组方法和属性,利用这些方法和属性,应用程序可以跟踪代码的执行并将跟踪消息和它们的源关联起来。
TraceSwitch提供多级开关控制跟踪和调试输出而不必重新编译代码。
UnescapedXmlDiagnosticData提供非转义 XML 数据以记录用户提供的跟踪数据。
XmlWriterTraceListener将跟踪或调试输出作为 XML 编码的数据定向到 TextWriterStream(如 FileStream)。
结构

  结构说明
CounterSample定义存放性能计数器的原始数据的结构。
接口

  接口说明
ICollectData基础结构。为系统使用性能计数器时加载的性能 DLL 准备性能数据。
委托

  委托说明
DataReceivedEventHandler表示将处理 ProcessOutputDataReceived 事件或 ErrorDataReceived 事件的方法。
EntryWrittenEventHandler表示将要处理 EventLogEntryWritten 事件的方法。
枚举

  枚举说明
DebuggableAttribute..::.DebuggingModes指定实时 (JIT) 编译器的调试模式。
DebuggerBrowsableState指定调试器的显示方式。
EventLogEntryType指定事件日志项的事件类型。
EventLogPermissionAccess定义 EventLog 权限类使用的访问级别。
OverflowAction指定如何处理已达到最大文件大小的事件日志中的项。
PerformanceCounterCategoryType指示性能计数器类别是否可以有多个实例。
PerformanceCounterInstanceLifetime指定性能计数器实例的生存期。
PerformanceCounterPermissionAccess定义 PerformanceCounter 权限类使用的访问级别。
PerformanceCounterTypePerformanceCounter 实例指定用于计算 NextValue 方法的公式。
PresentationTraceLevel说明对特定对象进行跟踪的详细等级。
ProcessPriorityClass指示系统将与进程关联的优先级。此值与进程的每个线程的优先级值一起来确定每个线程的基本优先级别。
ProcessWindowStyle指定在系统启动进程时新窗口应如何显示。
SourceLevels指定由源开关和事件类型筛选器筛选的跟踪消息的级别。
ThreadPriorityLevel指定线程的优先级别。
ThreadState指定线程的当前执行状态。
ThreadWaitReason指定线程等待的原因。
TraceEventType标识引起跟踪的事件的类型。
TraceLevel指定为 DebugTraceTraceSwitch 类输出的消息。
TraceLogRetentionOption指定将用于 EventSchemaTraceListener 日志的文件结构。
TraceOptions 指定要写入跟踪输出中的跟踪数据选项。
标记 :


Page view tracker