Freigeben über

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

Initialisiert eine neue Instanz der PerformanceCounter-Klasse im schreibgeschützten oder Lese-/Schreibmodus und ordnet sie dem angegebenen System- oder benutzerdefinierten Leistungsindikator und der angegebenen Kategorieinstanz auf dem lokalen Computer zu.

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

Syntax

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

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

public PerformanceCounter (
    string categoryName,
    string counterName,
    string instanceName,
    bool readOnly
)

public:
PerformanceCounter (
    String^ categoryName, 
    String^ counterName, 
    String^ instanceName, 
    bool readOnly
)

public PerformanceCounter (
    String categoryName, 
    String counterName, 
    String instanceName, 
    boolean readOnly
)

public function PerformanceCounter (
    categoryName : String, 
    counterName : String, 
    instanceName : String, 
    readOnly : boolean
)

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.
  • readOnly
    true, um im schreibgeschützten Modus auf einen Zähler zuzugreifen, false, um im Lese-/Schreibmodus auf einen Zähler zuzugreifen.

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 –

Die angegebene Kategorie ist nicht vorhanden. (Wenn readOnly den Wert true aufweist.)

– oder –

Die angegebene Kategorie ist keine benutzerdefinierte .NET Framework-Kategorie. (Wenn readOnly den Wert false aufweist.)

– 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.

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.

Verwenden Sie diese Überladung, um im schreibgeschützten oder im Lese-/Schreibmodus auf einen Leistungsindikator zuzugreifen.

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

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

Hinweis

Mit dieser Überladung können Sie eine Verbindung mit einem Systemzähler herstellen, ohne jedoch in diesen schreiben zu können. Daher wird, wenn Sie readOnly beim Verbinden mit einem Systemzähler auf false festlegen, vom Konstruktor eine Ausnahme ausgelöst.

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

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

  • Last updated on