PerformanceCounterCategory.Delete(String) Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Kaynak:

PerformanceCounterCategory.cs

Kategoriyi ve ilişkili sayaçlarını yerel bilgisayardan kaldırır.

public:
 static void Delete(System::String ^ categoryName);

public static void Delete (string categoryName);

static member Delete : string -> unit

Public Shared Sub Delete (categoryName As String)

Parametreler

categoryName

String

Silinecek özel performans sayacı kategorisinin adı.

Özel durumlar

ArgumentNullException

categoryName parametresidirnull.

ArgumentException

Parametrenin categoryName söz dizimi geçersiz. Ters eğik çizgi karakterleri ("\") içerebilir veya uzunluğu 80 karakterden büyük olabilir.

Win32Exception

Temel alınan sistem API'sine yapılan çağrı başarısız oldu.

InvalidOperationException

Özel bir kategori olmadığından kategori silinemiyor.

UnauthorizedAccessException

Yönetici ayrıcalıkları olmadan yürütülen kod bir performans sayacını okumaya çalıştı.

Örnekler

Aşağıdaki kod örneği, bir PerformanceCounterCategory ve PerformanceCounter içerdiği nesneleri silmek için yöntemini kullanırDelete.

public static void Main(string[] args)
{
    string categoryName = "";

    // Copy the supplied argument into the local variable.
    try
    {
        categoryName = args[0];
    }
    catch (Exception ex)
    {
        Console.WriteLine("Missing argument identifying category to be deleted.");
    }

    // Delete the specified category.
    try
    {
        if (PerformanceCounterCategory.Exists(categoryName))
        {
            PerformanceCounterCategory.Delete(categoryName);
            Console.WriteLine("Category \"{0}\" deleted from this computer.", categoryName);
        }
        else
        {
            Console.WriteLine("Category name not found");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unable to delete " +
            "category \"{0}\" from this computer:" + "\n" + ex.Message, categoryName);
    }
}

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
        Console.WriteLine("Missing argument identifying category to be deleted.")
    End Try

    ' Delete the specified category.
    Try
        If (PerformanceCounterCategory.Exists(categoryName)) Then
            PerformanceCounterCategory.Delete(categoryName)
            Console.WriteLine( _
                "Category ""{0}"" deleted from this computer.", categoryName)
        Else
            Console.WriteLine("Category name not found")
        End If

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

Açıklamalar

Sistemden yalnızca özel performans sayacı kategorilerini silebilirsiniz. Bir kategoriden sayaç silemezsiniz. Bunu yapmak için kategoriyi silin ve korumak istediğiniz sayaçlarla kategoriyi yeniden oluşturun. Özel durumdan kaçınmak için, silmeyi denemeden önce kategorinin var olduğunu onaylayın.

Not

Windows Vista ve sonraki sürümlerde, Windows XP Professional x64 Edition'da veya Windows Server 2003'te etkileşimli olmayan bir oturumdan performans sayaçlarını okumak için, Performans İzleyicisi Kullanıcıları grubunun üyesi olmanız veya yönetici ayrıcalıklarına sahip olmanız gerekir.

Windows Vista ve sonraki sürümlerde performans sayaçlarına erişmek için ayrıcalıklarınızı yükseltmek zorunda kalmamak için kendinizi Performans İzleyicisi Kullanıcıları grubuna ekleyin.

Windows Vista ve sonraki sürümlerde, Kullanıcı Hesabı Denetimi (UAC) bir kullanıcının ayrıcalıkları belirler. Yerleşik Yöneticiler grubunun bir üyesi iseniz, size iki çalışma zamanı erişim belirteci atanır: Standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolünde olursunuz. Performans sayaçlarına erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Bir uygulamayı başlattığınızda, uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek bunu yapabilirsiniz.

Ayrıca bkz.

• Create(String, String, CounterCreationDataCollection)