PerformanceCounter-Konstruktor (String, String, Boolean)

Artikel
08/20/2007

Initialisiert eine neue Instanz der PerformanceCounter-Klasse im schreibgeschützten oder Lese-/Schreibmodus und ordnet sie dem angegebenen System- oder benutzerdefinierten Leistungsindikator auf dem lokalen Computer zu. Für diesen Konstruktor muss die Kategorie eine einzelne Instanz enthalten.

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

Syntax

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

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

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

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

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

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

Parameter

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

counterName
Der Name des Leistungsindikators.

readOnly
true, um im schreibgeschützten Modus auf den Zähler zuzugreifen (wobei sich der Zähler selbst jedoch im Lese-/Schreibmodus befinden kann), false, um im Lese-/Schreibmodus auf den Zähler zuzugreifen.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	categoryName ist eine leere Zeichenfolge (""). – oder – counterName ist eine leere Zeichenfolge (""). – 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.
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 im schreibgeschützten oder Lese-/Schreibmodus 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.

Durch diese Überladung des Konstruktors werden die CategoryName-Eigenschaft, die CounterName-Eigenschaft und die ReadOnly-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. 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.

Beispiel

PC = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

PC = new PerformanceCounter("AverageCounter64SampleCategory", 
    "AverageCounter64Sample", 
    false);

PC = gcnew PerformanceCounter( "AverageCounter64SampleCategory","AverageCounter64Sample",false );

pc = new PerformanceCounter("AverageCounter64SampleCategory",
    "AverageCounter64Sample", false);

.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