PerformanceCounter.RemoveInstance メソッド

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

PerformanceCounter.RemoveInstance メソッド

PerformanceCounter オブジェクトの InstanceName プロパティで指定されたカテゴリ インスタンスを削除します。

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

Visual Basic (宣言)

Public Sub RemoveInstance

Visual Basic (使用法)

Dim instance As PerformanceCounter

instance.RemoveInstance

C#

public void RemoveInstance ()

C++

public:
void RemoveInstance ()

J#

public void RemoveInstance ()

JScript

public function RemoveInstance ()

例外

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

解説

削除できるのは、カスタム カウンタのインスタンスだけです。すべてのシステム カウンタは読み取り専用であるため、削除しようとすると例外がスローされます。

メモ
パフォーマンス カウンタの共有メモリの解放時に発生する可能性のある競合状態を回避するために、DomainUnload イベント ハンドラから RemoveInstance メソッドを呼び出すことをお勧めします。

パフォーマンス カテゴリ インスタンスを作成するには、PerformanceCounter コンストラクタで instanceName を指定します。instanceName で指定されたカテゴリ インスタンスが既に存在する場合、新しいオブジェクトは既存のカテゴリ インスタンスを参照します。

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

.NET Framework のセキュリティ

• PerformanceCounterPermission  (パフォーマンス カウンタ カテゴリを書き込むために必要なアクセス許可)。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 名前空間