PerformanceCounter.Increment メソッド

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

PerformanceCounter.Increment メソッド

有効な分割不可能な操作を通じて、関連付けられたパフォーマンス カウンタを 1 ずつインクリメントします。

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

Visual Basic (宣言)

Public Function Increment As
 Long

Visual Basic (使用法)

Dim instance As PerformanceCounter
Dim returnValue As Long

returnValue = instance.Increment

C#

public long Increment ()

C++

public:
long long Increment ()

J#

public long Increment ()

JScript

public function Increment () : long

戻り値
インクリメントされたカウンタ値。

例外

例外の種類	条件
InvalidOperationException	カウンタは読み取り専用です。そのため、アプリケーションによるインクリメントができません。 または インスタンスがパフォーマンス カウンタに正しく関連付けられていません。 または グローバル共有メモリを使用する場合、InstanceLifetime プロパティは Process に設定されます。
Win32Exception	システム API へのアクセス中にエラーが発生しました。
PlatformNotSupportedException	プラットフォームが Windows 98 または Windows Millennium Edition (Me) です。パフォーマンス カウンタはサポートされません。

解説

書き込むことができるのはカスタム カウンタだけです。すべてのシステム カウンタは読み取り専用です。

メモ
Increment メソッド、IncrementBy メソッド、および Decrement メソッドでは、インタロックを使用してカウンタの値を更新します。これにより、マルチスレッドやマルチプロセスの状況でもカウンタ値を正確に維持できますが、パフォーマンスの低下が生じます。インタロックを使用した処理による正確性が不要な場合は、RawValue プロパティを直接更新することで、パフォーマンスを最大 5 倍に高めることができます。ただし、マルチスレッドの場合、カウンタ値の更新の一部が無視され、データが不正確になる可能性があります。

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (ReadOnly プロパティが true である場合にパフォーマンス カウンタ カテゴリを読み取るために必要なアクセス許可)。PerformanceCounterPermissionAccess.Read (関連する列挙体)
• PerformanceCounterPermission  (ReadOnly プロパティが false である場合にパフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。PerformanceCounterPermissionAccess.Write (関連する列挙体)

プラットフォーム

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 名前空間