PerformanceCounterCategory.Delete メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

PerformanceCounterCategory.Delete メソッド

カテゴリとそれに関連付けられているカウンタをローカルコンピュータから削除します。

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

Visual Basic (宣言)

Public Shared Sub Delete
 ( _
    categoryName As String _
)

Visual Basic (使用法)

Dim categoryName As String

PerformanceCounterCategory.Delete(categoryName)

public static void Delete
 (
    string categoryName
)

C++

public:
static void Delete (
    String^ categoryName
)

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	カテゴリがカスタムカテゴリではないため、削除できません。

解説

システムから削除できるのは、カスタムパフォーマンスカウンタカテゴリだけです。カウンタはカテゴリから削除できません。カウンタをカテゴリから削除するには、カテゴリを削除し、継続して使用するカウンタでカテゴリを再作成します。

使用例

Delete メソッドを使用して、PerformanceCounterCategory および格納されている PerformanceCounter オブジェクトを削除するコード例を次に示します。

Visual Basic

Sub Main(ByVal args() As
 String)
    Dim categoryName As String
 = ""

    ' Copy the supplied argument into the local variable.
    Try
        categoryName = args(0)
    Catch ex As Exception
    End Try

    ' Delete the specified category.
    Try
        PerformanceCounterCategory.Delete(categoryName)
        Console.WriteLine( _
            "Category ""{0}""
 deleted from this computer.", categoryName)

    Catch ex As Exception
        Console.WriteLine("Unable to delete " &
 _
            "category ""{0}""
 from this computer:" & vbCrLf & _
            ex.Message, categoryName)
    End Try
End Sub