PerformanceCounterCategory-Konstruktor (String)

Initialisiert eine neue Instanz der PerformanceCounterCategory-Klasse, legt die CategoryName-Eigenschaft auf den angegebenen Wert und die MachineName-Eigenschaft auf den lokalen Computer fest.

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

Syntax

'Declaration
Public Sub New ( _
    categoryName As String _
)
'Usage
Dim categoryName As String

Dim instance As New PerformanceCounterCategory(categoryName)

public PerformanceCounterCategory (
    string categoryName
)

public:
PerformanceCounterCategory (
    String^ categoryName
)

public PerformanceCounterCategory (
    String categoryName
)

public function PerformanceCounterCategory (
    categoryName : String
)

Parameter

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

Ausnahmen

Beispiel

Im folgenden Codebeispiel werden ein PerformanceCounterCategory-Name und ein Computername über die Befehlszeile angenommen. Mit der für die bereitgestellte Anzahl von Parametern geeigneten Konstruktorüberladung wird eine PerformanceCounterCategory erstellt, und dann werden die Eigenschaften angezeigt.

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

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        machineName = IIf(args(1) = ".", "", args(1))
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    ' Create a PerformanceCounterCategory object using 
    ' the appropriate constructor.
    If categoryName.Length = 0 Then
        pcc = New PerformanceCounterCategory
    ElseIf machineName.Length = 0 Then
        pcc = New PerformanceCounterCategory(categoryName)
    Else
        pcc = New PerformanceCounterCategory(categoryName, machineName)
    End If

    ' 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

• PerformanceCounterPermission  zum Lesen von Kategorieinformationen wie dem Kategorienamen. 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
CategoryName
MachineName
PerformanceCounter-Klasse