PerformanceCounter-Konstruktor (String, String)

Artikel
08/20/2007

Initialisiert eine neue, schreibgeschützte Instanz der PerformanceCounter-Klasse und ordnet sie dem angegebenen System- oder benutzerdefinierten Leistungsindikator auf dem lokalen Computer zu. Für diesen Konstruktor muss die Kategorie eine einzelne Instanz besitzen.

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

Syntax

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

Dim instance As New PerformanceCounter(categoryName, counterName)

public PerformanceCounter (
    string categoryName,
    string counterName
)

public:
PerformanceCounter (
    String^ categoryName, 
    String^ counterName
)

public PerformanceCounter (
    String categoryName, 
    String counterName
)

public function PerformanceCounter (
    categoryName : String, 
    counterName : String
)

Parameter

categoryName
Der Name der Leistungsindikatorkategorie (bzw. des Leistungsobjekts), der dieser Leistungsindikator zugeordnet ist.

counterName
Der Name des Leistungsindikators.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	categoryName ist eine leere Zeichenfolge (""). – oder – counterName ist eine leere Zeichenfolge (""). – oder – Die angegebene Kategorie ist nicht vorhanden. – oder – Die angegebene Kategorie ist als eine Kategorie mit mehreren Instanzen markiert und erfordert, dass der Leistungsindikator mit einem Instanznamen erstellt wird.
ArgumentNullException	Der categoryName-Parameter oder counterName-Parameter ist NULL (Nothing in Visual Basic).
Win32Exception	Fehler beim Zugriff auf eine System-API.
PlatformNotSupportedException	Die Plattform ist Windows 98 oder Windows Millennium Edition (Me), die keine Leistungsindikatoren unterstützen.

Hinweise

Bei den Parameterzeichenfolgen wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Mit dieser Überladung können Sie auf dem lokalen Computer auf einen Zähler zugreifen, der zu einer Kategorie gehört, die eine einzelne Instanz einer Leistungsindikatorkategorie enthält. Wenn Sie mit diesem Konstruktor versuchen, diese PerformanceCounter-Instanz auf eine Kategorie mit mehreren Instanzen zeigen zu lassen, löst der Konstruktor eine Ausnahme aus. Diese Überladung kann auf beliebige Zähler im schreibgeschützten oder im Lese-/Schreibmodus zugreifen. Der Vorgang selbst wird jedoch in schreibgeschütztem Modus ausgeführt. Eine mit dieser Überladung erstellte PerformanceCounter-Instanz kann nicht in den Zähler schreiben, selbst wenn sich der Zähler im Lese-/Schreibmodus befindet.

Durch diese Überladung des Konstruktors werden die CategoryName-Eigenschaft und die CounterName-Eigenschaft auf die übergebenen Werte, die MachineName-Eigenschaft auf den lokalen Computer (".") und die InstanceName-Eigenschaft auf eine leere Zeichenfolge ("") festgelegt.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet die Instanz einem vorhandenen System- oder benutzerdefinierten Zähler auf dem lokalen Computer zu. Die für die CategoryName-Eigenschaft und die CounterName-Eigenschaft übergebenen Werte müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer zeigen.

.NET Framework-Sicherheit

PerformanceCounterPermission zum Lesen der Leistungsindikatorkategorie, wenn die ReadOnly-Eigenschaft true ist. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Read
PerformanceCounterPermission zum Schreiben der Leistungsindikatorkategorie, wenn die ReadOnly-Eigenschaft false ist. Zugeordnete Enumeration: PerformanceCounterPermissionAccess.Write

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

PerformanceCounter-Klasse
PerformanceCounter-Member
System.Diagnostics-Namespace

Freigeben über