PerformanceCounter.CounterType プロパティ

[アーティクル]
08/14/2007

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

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

構文

'宣言
Public ReadOnly Property CounterType As PerformanceCounterType
'使用
Dim instance As PerformanceCounter
Dim value As PerformanceCounterType

value = instance.CounterType

public PerformanceCounterType CounterType { get; }

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

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

public function get CounterType () : PerformanceCounterType

プロパティ値

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

例外

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

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

次の方法で共有