PerformanceCounter.CounterType プロパティ

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

PerformanceCounter.CounterType プロパティ

関連付けられているパフォーマンス カウンタのカウンタ タイプを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 CounterType As PerformanceCounterType

Visual Basic (使用法)

Dim instance As PerformanceCounter
Dim value As PerformanceCounterType

value = instance.CounterType

C#

public PerformanceCounterType CounterType { get;
 }

C++

public:
property PerformanceCounterType CounterType {
    PerformanceCounterType get ();
}

J#

/** @property */
public PerformanceCounterType get_CounterType ()

JScript

public function get CounterType
 () : PerformanceCounterType

プロパティ値
カウンタと監視中のアプリケーションがやり取りする方法と、カウンタに格納される値の性質 (計算される値か、計算されない値かなど) の両方を説明する PerformanceCounterType。

例外

例外の種類	条件
InvalidOperationException	インスタンスがパフォーマンス カウンタに正しく関連付けられていません。 または グローバル共有メモリを使用する場合、InstanceLifetime プロパティは Process に設定されます。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

PerformanceCounterType 列挙体には、やり取りするパフォーマンス カウンタのタイプが格納されています。いくつかのカウンタ タイプは、システムが取得したカウンタ測定値の平均など、計算される値を表します。別のタイプは、生の、つまり計算されない値を表します。頻繁にやり取りするカウンタ タイプを次の表に示します。

カウンタの役割	PerformanceCounterType 値	例
項目または操作の単純なカウントを保持します。	NumberOfItems32	32 ビット整数として受け取った命令数を追跡します。
大容量の単純なカウントを保持します。	NumberOfItems64	大規模なボリュームを持つサイトの命令数を追跡します。64 ビット整数として格納されます。
1 秒あたりの項目または操作の数を追跡します。	RateOfCountsPerSecond32	サイトで 1 秒間に受け取った命令を追跡します。
1 秒あたりの項目または操作の数のうち大きな数を追跡します。	RateOfCountsPerSecond64	大規模なボリュームを持つサイトで 1 秒間に受け取った命令を追跡します。
プロセスの平均実行時間または項目の平均処理時間を計算します。	AverageTimer32	命令の処理にかかる平均時間を計算します。

対応するベース カウンタを使用する必要があるタイプのカウンタを作成するときは、PerformanceCounterCategory.Create メソッドに渡す CounterCreationDataCollection でカウンタとベースを宣言する必要があります。

メモ
InstanceLifetime プロパティの値が Process のとき、パフォーマンス カウンタ カテゴリが .NET Framework Version 1.0 または 1.1 で作成されている場合、InvalidOperationException がスローされます。グローバル共有メモリを使用する古いバージョンでパフォーマンス カウンタ カテゴリが作成されている場合、InstanceLifetime の値は Global に設定する必要があります。このカテゴリが .NET Framework Version 1.0 または 1.1 で実行されるアプリケーションで使用されない場合、カテゴリを削除して再作成します。

.NET Framework のセキュリティ

• PerformanceCounterPermission  (パフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)

プラットフォーム

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

参照

関連項目
PerformanceCounter クラス
PerformanceCounter メンバ
System.Diagnostics 名前空間
PerformanceCounterType