通过

PerformanceCounterCategory.ReadCategory 方法

  • 项目

读取与此性能计数器类别关联的所有计数器和性能对象实例数据。

**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）

语法

声明
Public Function ReadCategory As InstanceDataCollectionCollection
用法
Dim instance As PerformanceCounterCategory
Dim returnValue As InstanceDataCollectionCollection

returnValue = instance.ReadCategory

public InstanceDataCollectionCollection ReadCategory ()

public:
InstanceDataCollectionCollection^ ReadCategory ()

public InstanceDataCollectionCollection ReadCategory ()

public function ReadCategory () : InstanceDataCollectionCollection

返回值

一个 InstanceDataCollectionCollection，它包含类别的计数器和性能对象实例数据。

异常

异常类型 条件

InvalidOperationException

CategoryName 属性为 空引用（在 Visual Basic 中为 Nothing）。可能尚未设置该属性。

Win32Exception

对基础系统 API 的调用失败。

备注

调用 ReadCategory 前必须设置 CategoryName 属性。

由于系统提供数据的方式，同时读取整个类别可与读取单个计数器一样有效。

示例

下面的代码示例为指定的 PerformanceCounterCategory 名称创建 PerformanceCounterCategory。然后使用 ReadCategory 返回一个 InstanceDataCollectionCollection，其中包含 PerformanceCounterCategory 中的 PerformanceCounter 对象的所有实例的实例数据。

' Process the InstanceDataCollectionCollection for this category.
Dim pcc As New PerformanceCounterCategory(categoryName)
Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()
Dim idColArray(idColCol.Count - 1) As InstanceDataCollection

Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
    "has {1} elements.", categoryName, idColCol.Count)

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

PerformanceCounterCategory 类
PerformanceCounterCategory 成员
System.Diagnostics 命名空间
InstanceDataCollectionCollection 类
InstanceDataCollection 类
InstanceData 类