PerformanceCounterCategory.CategoryName-Eigenschaft

Artikel
08/20/2007

Ruft den Namen des Leistungsobjekts ab, das diese Kategorie definiert, oder legt diesen fest.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property CategoryName As String
'Usage
Dim instance As PerformanceCounterCategory
Dim value As String

value = instance.CategoryName

instance.CategoryName = value

public string CategoryName { get; set; }

public:
property String^ CategoryName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_CategoryName ()

/** @property */
public void set_CategoryName (String value)

public function get CategoryName () : String

public function set CategoryName (value : String)

Eigenschaftenwert

Der Name der Leistungsindikatorkategorie oder des Leistungsobjekts, der bzw. dem diese PerformanceCounterCategory-Instanz zugeordnet werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der CategoryName ist eine leere Zeichenfolge ("").
ArgumentNullException	Der CategoryName ist NULL (Nothing in Visual Basic).

Beispiel

Im folgenden Beispiel wird eine PerformanceCounterCategory mit der PerformanceCounterCategory erstellt. Der Benutzer wird zum Eingeben des PerformanceCounterCategory-Namens und des Computernamens aufgefordert. Dann werden die CategoryName-Eigenschaft und die MachineName-Eigenschaft anhand der eingegebenen Werte festgelegt. Anschließend werden die Werte der CategoryName-Eigenschaft, der MachineName-Eigenschaft und der CategoryHelp-Eigenschaft angezeigt, oder es wird eine Fehlermeldung angezeigt, wenn nicht auf die PerformanceCounterCategory zugegriffen werden kann.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim machineName As String = ""
    Dim pcc As New PerformanceCounterCategory

    ' Prompt for fields and set the corresponding properties.
    While categoryName.Length = 0
        Console.Write("Please enter a non-blank category name: ")
        categoryName = Console.ReadLine().Trim
        If categoryName.Length > 0 Then
            pcc.CategoryName = categoryName
        End If
    End While
    While machineName.Length = 0
        Console.Write( _
            "Enter a non-blank computer name ['.' for local]: ")
        machineName = Console.ReadLine().Trim
        If machineName.Length > 0 Then
            pcc.MachineName = machineName
        End If
    End While

    ' Display the properties of the PerformanceCounterCategory object.
    Try
        Console.WriteLine("  Category:  {0}", pcc.CategoryName)
        Console.WriteLine("  Computer:  {0}", pcc.MachineName)
        Console.WriteLine("  Help text: {0}", pcc.CategoryHelp)
    Catch ex As Exception
        Console.WriteLine("Error getting the properties of the " & _
            "PerformanceCounterCategory object:")
        Console.WriteLine(ex.Message)
    End Try
End Sub

.NET Framework-Sicherheit

PerformanceCounterPermissionAccess zum Lesen von Leistungsindikatorkategorien. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Read.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PerformanceCounterCategory-Klasse
PerformanceCounterCategory-Member
System.Diagnostics-Namespace
MachineName
PerformanceCounter-Klasse

Freigeben über