PerformanceCounterCategory-Konstruktor (String, String)

Initialisiert eine neue Instanz der PerformanceCounterCategory-Klasse und legt die CategoryName-Eigenschaft und die MachineName-Eigenschaft auf die angegebenen Werte fest.

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

Syntax

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

Dim instance As New PerformanceCounterCategory(categoryName, machineName)

public PerformanceCounterCategory (
    string categoryName,
    string machineName
)

public:
PerformanceCounterCategory (
    String^ categoryName, 
    String^ machineName
)

public PerformanceCounterCategory (
    String categoryName, 
    String machineName
)

public function PerformanceCounterCategory (
    categoryName : String, 
    machineName : String
)

Parameter

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

• machineName
  Der Computer, auf dem die Leistungsindikatorkategorie und die zugeordneten Indikatoren vorhanden sind.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der categoryName ist eine leere Zeichenfolge (""). – oder – Die Syntax für machineName ist ungültig.
ArgumentNullException	Der categoryName ist NULL (Nothing in Visual Basic).

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 Computer- und 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