PerformanceCounterCategory.Delete メソッド
カテゴリとそれに関連付けられているカウンタをローカル コンピュータから削除します。
Public Shared Sub Delete( _
ByVal categoryName As String _)
[C#]
public static void Delete(stringcategoryName);
[C++]
public: static void Delete(String* categoryName);
[JScript]
public static function Delete(
categoryName : String);
パラメータ
- categoryName
削除するカスタム パフォーマンス カウンタ カテゴリの名前。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | categoryName パラメータが null 参照 (Visual Basic では Nothing) です。 |
ArgumentException | categoryName パラメータの構文が無効です。円記号文字 ("\") が含まれているか、長さが 80 文字を超えています。 |
Win32Exception | 基になるシステム API の呼び出しに失敗しました。 |
InvalidOperationException | カテゴリがカスタム カテゴリではないため、削除できません。 |
解説
システムから削除できるのは、カスタム パフォーマンス カウンタ カテゴリだけです。カウンタはカテゴリから削除できません。カウンタをカテゴリから削除するには、カテゴリを削除し、継続して使用するカウンタでカテゴリを再作成します。
必要条件
プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- PerformanceCounterPermissionAccess (パフォーマンス カウンタ カテゴリに対して管理タスクを実行するために必要なアクセス許可)
参照
PerformanceCounterCategory クラス | PerformanceCounterCategory メンバ | System.Diagnostics 名前空間 | Create