PerformanceCounter-Konstruktor (String, String, String, String)

Initialisiert eine neue, schreibgeschützte Instanz der PerformanceCounter-Klasse und ordnet sie dem angegebenen System- oder benutzerdefinierten Leistungsindikator sowie der angegebenen Kategorieinstanz auf dem angegebenen Computer zu.

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

Syntax

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

Dim instance As New PerformanceCounter(categoryName, counterName, instanceName, machineName)

public PerformanceCounter (
    string categoryName,
    string counterName,
    string instanceName,
    string machineName
)

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

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    String instanceName, 
    String machineName
)

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

Parameter

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

• counterName
  Der Name des Leistungsindikators.

• instanceName
  Der Name der Instanz der Leistungsindikatorkategorie oder eine leere Zeichenfolge (""), wenn die Kategorie eine einzelne Instanz enthält.

• machineName
  Der Computer, auf dem der Leistungsindikator sowie die ihm zugeordnete Kategorie vorhanden sind.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	categoryName ist eine leere Zeichenfolge (""). – oder – counterName ist eine leere Zeichenfolge (""). – oder – Die angeforderte Einstellung für die Lese-/Schreibberechtigung ist für diesen Zähler ungültig. – oder – Der Zähler ist auf dem angegebenen Computer nicht vorhanden. – oder – Die angegebene Kategorie ist als eine Kategorie mit mehreren Instanzen markiert und erfordert, dass der Leistungsindikator mit einem Instanznamen erstellt wird. – oder – instanceName ist länger als 127 Zeichen.
ArgumentException	Der machineName-Parameter ist ungültig.
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.

Durch diese Überladung des Konstruktors werden die CategoryName-Eigenschaft, die CounterName-Eigenschaft, die InstanceName-Eigenschaft und die MachineName-Eigenschaft auf die übergebenen Werte festgelegt.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet die Instanz einem vorhandenen System- oder benutzerdefinierten Zähler auf dem angegebenen Computer zu. Die von Ihnen übergebenen Werte für die CategoryName-Eigenschaft, die CounterName-Eigenschaft, die InstanceName-Eigenschaft und die MachineName-Eigenschaft müssen auf einen vorhandenen Leistungsindikator zeigen. Wenn Sie auf eine ungültige Leistungsindikatorinstanz zeigen, wird beim Aufrufen des Konstruktors eine Ausnahme ausgelöst. 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.

Hinweis

In Remoteleistungsindikatoren kann nicht geschrieben werden. Es kann mit keiner Überladung eine Lese-/Schreibinstanz der PerformanceCounter-Klasse angegeben werden, die mit einem Remotecomputer verbunden werden kann.

Geben Sie zum Erstellen einer Instanz einer Leistungskategorie einen instanceName für den PerformanceCounter-Konstruktor an. Wenn die durch instanceName bezeichnete Kategorieinstanz bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorieinstanz.

.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