PerformanceCounter.RemoveInstance メソッドとは何？ わかりやすく解説 Weblio辞書 (original) (raw)

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 のセキュリティ.NET Framework のセキュリティ

プラットフォームプラットフォーム

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