PerformanceCounterCategory.ReadCategory メソッド

.NET Framework クラス ライブラリ リファレンス

PerformanceCounterCategory.ReadCategory メソッド

このパフォーマンス カウンタ カテゴリに関連付けられたすべてのカウンタとパフォーマンス オブジェクト インスタンスのデータを読み取ります。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function ReadCategory As
 InstanceDataCollectionCollection

Visual Basic (使用法)

Dim instance As PerformanceCounterCategory
Dim returnValue As InstanceDataCollectionCollection

returnValue = instance.ReadCategory

C#

public InstanceDataCollectionCollection ReadCategory ()

C++

public:
InstanceDataCollectionCollection^ ReadCategory ()

J#

public InstanceDataCollectionCollection ReadCategory ()

JScript

public function ReadCategory () : InstanceDataCollectionCollection

戻り値
カテゴリのカウンタとパフォーマンス オブジェクト インスタンスのデータを格納している InstanceDataCollectionCollection。

例外

例外の種類	条件
InvalidOperationException	CategoryName プロパティが null 参照 (Visual Basic では Nothing) です。プロパティが設定されていない可能性があります。
Win32Exception	基になるシステム API の呼び出しに失敗しました。

解説

ReadCategory を呼び出す前に、CategoryName プロパティを設定する必要があります。

カテゴリ全体の一括読み取りは、単一カウンタの読み取りと同じくらいに効率的です。その理由は、システムがデータを提供する方法にあります。

使用例

指定された PerformanceCounterCategory 名のPerformanceCounterCategory を作成するコード例を次に示します。次に、ReadCategory を使用して、PerformanceCounterCategory 内の PerformanceCounter オブジェクトのすべてのインスタンスのインスタンス データを格納する InstanceDataCollectionCollection を返します。

Visual Basic

' 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 クラス