PerformanceCounter Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Initialisiert eine neue Instanz der PerformanceCounter-Klasse.

Überlädt

PerformanceCounter()	Initialisiert eine neue, schreibgeschützte Instanz der PerformanceCounter-Klasse, ohne diese Instanz einem System- oder benutzerdefinierten Leistungsindikator zuzuordnen.
PerformanceCounter(String, String)	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.
PerformanceCounter(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 auf dem lokalen Computer zu. Für diesen Konstruktor muss die Kategorie eine einzelne Instanz enthalten.
PerformanceCounter(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 lokalen Computer zu.
PerformanceCounter(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.
PerformanceCounter(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.

PerformanceCounter()

Quelle:

PerformanceCounter.cs

Initialisiert eine neue, schreibgeschützte Instanz der PerformanceCounter-Klasse, ohne diese Instanz einem System- oder benutzerdefinierten Leistungsindikator zuzuordnen.

public:
 PerformanceCounter();

public PerformanceCounter ();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird eine Standard-instance der PerformanceCounter -Klasse erstellt. Nachdem die instance erstellt wurde, werden die CategoryNameEigenschaftswerte , CounterNameund InstanceName festgelegt, und die Ergebnisse eines Aufrufs der NextValue -Methode werden angezeigt.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Hinweise

Diese Überladung des Konstruktors legt die CategoryNameEigenschaften , CounterNameund InstanceName auf leere Zeichenfolgen ("") und die MachineName Eigenschaft auf den lokalen Computer (".") fest.

Dieser Konstruktor initialisiert den Leistungsindikator nicht, sodass er den instance nicht einem vorhandenen Leistungsindikator auf dem lokalen Computer ordnet. Um auf einen bestimmten Leistungsindikator zu verweisen, legen Sie die CategoryNameEigenschaften , CounterNameund optional die InstanceName Eigenschaften und MachineName fest, bevor Sie andere Eigenschaften lesen oder versuchen, aus einem Leistungsindikator zu lesen. Um in einen Leistungsindikator zu schreiben, legen Sie die ReadOnly -Eigenschaft auf fest false.

Hinweis

Das HostProtectionAttribute Attribut, das auf dieses Element angewendet wird, weist den folgenden Resources Eigenschaftswert auf: | SynchronizationSharedState . Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie in der HostProtectionAttribute Klasse oder SQL Server Programming and Host Protection Attribute.

PerformanceCounter(String, String)

Quelle:

PerformanceCounter.cs

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.

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

public PerformanceCounter (string categoryName, string counterName);

new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String)

Parameter

categoryName

String

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

counterName

String

Der Name des Leistungsindikators.

Ausnahmen

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 Mehrfachinstanz gekennzeichnet und erfordert es, dass der Leistungsindikator mit einem Instanznamen erstellt wird.

- oder -

categoryName und counterName wurden in verschiedenen Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

UnauthorizedAccessException

Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.

Hinweise

Bei den Parameterzeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

Verwenden Sie diese Überladung, um auf einen Leistungsindikator auf dem lokalen Computer zuzugreifen, der zu einer Kategorie gehört, die eine einzelne Leistungsindikatorkategorie instance enthält. Wenn Sie versuchen, diesen Konstruktor zu verwenden, um diese PerformanceCounter instance auf eine Kategorie zu verweisen, die mehrere Instanzen enthält, löst der Konstruktor eine Ausnahme aus. Diese Überladung kann auf jeden schreibgeschützten oder Lese-/Schreibindikator zugreifen, dies erfolgt jedoch in einem schreibgeschützten Modus. Ein PerformanceCounter instance, der mit dieser Überladung erstellt wurde, kann nicht in den Zähler schreiben, auch wenn der Indikator selbst Lese-/Schreibzugriff hat.

Diese Überladung des Konstruktors legt die CategoryName Eigenschaften und CounterName auf die von Ihnen übergebenen Werte fest, legt die MachineName Eigenschaft auf den lokalen Computer fest, ".", und legt die InstanceName Eigenschaft auf eine leere Zeichenfolge ("") fest.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet den instance einem vorhandenen Leistungsindikator (entweder einem System oder einem benutzerdefinierten Leistungsindikator) auf dem lokalen Computer zu. Die Werte, die Sie für die CategoryName Eigenschaften und CounterName übergeben, müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen.

Hinweis

Zum Lesen von Leistungsindikatoren aus einer nicht interaktiven Anmeldesitzung in Windows Vista und höher, Windows XP Professional x64 Edition oder Windows Server 2003 müssen Sie entweder Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.

Um zu vermeiden, dass Sie Ihre Berechtigungen für den Zugriff auf Leistungsindikatoren in Windows Vista erhöhen müssen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.

Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer auf den Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.

PerformanceCounter(String, String, Boolean)

Quelle:

PerformanceCounter.cs

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.

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

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

new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

Parameter

categoryName

String

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

counterName

String

Der Name des Leistungsindikators.

readOnly

Boolean

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

InvalidOperationException

Der categoryName ist eine leere Zeichenfolge ("").

- oder -

Der counterName ist eine leere Zeichenfolge ("").

- oder -

Die angegebene Kategorie ist nicht vorhanden. (Wenn readOnlytrue ist.)

- oder -

Die angegebene Kategorie ist keine benutzerdefinierte .NET Framework-Kategorie (wenn readOnlyfalse ist).

- oder -

Die angegebene Kategorie ist als Mehrfachinstanz gekennzeichnet und erfordert es, dass der Leistungsindikator mit einem Instanznamen erstellt wird.

- oder -

categoryName und counterName wurden in verschiedenen Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

UnauthorizedAccessException

Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.

Beispiele

Im folgenden Codebeispiel wird eine instance der PerformanceCounter -Klasse erstellt. Im Beispiel werden Kategorienamen, Zählernamen und ein Flagwert übergeben, der angibt, dass der Zähler nicht schreibgeschützt ist. Dieses Codebeispiel ist Teil eines größeren Beispiels für die PerformanceCounter -Klasse.

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

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

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

Hinweise

Bei den Parameterzeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

Verwenden Sie diese Überladung, um auf einen schreibgeschützten oder schreibgeschützten Leistungsindikator auf dem lokalen Computer zuzugreifen, der zu einer Kategorie gehört, die eine einzelne Leistungsindikatorkategorie instance enthält. Wenn Sie versuchen, diesen Konstruktor zu verwenden, um diese PerformanceCounter instance auf eine Kategorie zu verweisen, die mehrere Instanzen enthält, löst der Konstruktor eine Ausnahme aus.

Diese Überladung des Konstruktors legt die CategoryNameEigenschaften , CounterNameund ReadOnly auf die von Ihnen übergebenen Werte fest, legt die MachineName Eigenschaft auf den lokalen Computer "." und die InstanceName Eigenschaft auf eine leere Zeichenfolge ("") fest.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet den instance einem vorhandenen Leistungsindikator (entweder einem System oder einem benutzerdefinierten Leistungsindikator) auf dem lokalen Computer zu. Die Werte, die Sie für die CategoryName Eigenschaften und CounterName übergeben, müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen. Wenn der Leistungsindikator instance, auf den Sie verweisen, ungültig ist, löst das Aufrufen des Konstruktors eine Ausnahme aus.

Hinweis

Sie können diese Überladung verwenden, um eine Verbindung mit einem Systemindikator herzustellen, aber Sie können nicht in einen Systemindikator schreiben. Daher führt die Einstellung readOnly auf beim false Herstellen einer Verbindung mit einem Systemindikator dazu, dass der Konstruktor eine Ausnahme auslöst.

Hinweis

Zum Lesen von Leistungsindikatoren aus einer nicht interaktiven Anmeldesitzung in Windows Vista und höher, Windows XP Professional x64 Edition oder Windows Server 2003 müssen Sie entweder Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.

Um zu vermeiden, dass Sie Ihre Berechtigungen für den Zugriff auf Leistungsindikatoren in Windows Vista erhöhen müssen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.

Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer auf den Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.

PerformanceCounter(String, String, String)

Quelle:

PerformanceCounter.cs

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

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);

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

new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String)

Parameter

categoryName

String

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

counterName

String

Der Name des Leistungsindikators.

instanceName

String

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

Ausnahmen

InvalidOperationException

categoryName ist eine leere Zeichenfolge ("").

- oder -

counterName ist eine leere Zeichenfolge ("").

- oder -

Die angegebene Kategorie ist ungültig.

- oder -

Die angegebene Kategorie ist als Mehrfachinstanz gekennzeichnet und erfordert es, dass der Leistungsindikator mit einem Instanznamen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedenen Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

UnauthorizedAccessException

Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.

Hinweise

Bei den Parameterzeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

Diese Überladung des Konstruktors legt die CategoryNameEigenschaften , CounterNameund InstanceName auf die werte fest, die Sie übergeben, und legt die MachineName Eigenschaft auf den lokalen Computer "." fest.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet den instance einem vorhandenen Leistungsindikator (entweder einem System oder einem benutzerdefinierten Leistungsindikator) auf dem lokalen Computer zu. Die Werte, die Sie für die CategoryNameEigenschaften , CounterNameund übergeben, InstanceName müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen. Wenn der Leistungsindikator, auf instance Sie verweisen, ungültig ist, löst das Aufrufen des Konstruktors eine Ausnahme aus.

Diese Überladung kann auf jeden schreibgeschützten oder Lese-/Schreibindikator zugreifen, dies erfolgt jedoch in einem schreibgeschützten Modus. Ein PerformanceCounter instance, der mit dieser Überladung erstellt wurde, kann nicht in den Zähler schreiben, auch wenn der Indikator selbst Lese-/Schreibzugriff hat.

Um eine Leistungskategorie instance zu erstellen, geben Sie einen instanceName für den PerformanceCounter Konstruktor an. Wenn die von instanceName angegebene Kategorie instance bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorie instance.

Hinweis

Zum Lesen von Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 müssen Sie entweder Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.

Um zu vermeiden, dass Sie Ihre Berechtigungen für den Zugriff auf Leistungsindikatoren in Windows Vista erhöhen müssen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.

Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer auf den Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.

PerformanceCounter(String, String, String, Boolean)

Quelle:

PerformanceCounter.cs

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.

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

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

new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

Parameter

categoryName

String

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

counterName

String

Der Name des Leistungsindikators.

instanceName

String

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

readOnly

Boolean

true, um im schreibgeschützten Modus auf einen Zähler zuzugreifen, false, um im Lese-/Schreibmodus auf einen Zähler zuzugreifen.

Ausnahmen

InvalidOperationException

categoryName ist eine leere Zeichenfolge ("").

- oder -

counterName ist eine leere Zeichenfolge ("").

- oder -

Die angeforderte Lese-/Schreibberechtigungseinstellung ist für diesen Indikator ungültig.

- oder -

Die angegebene Kategorie ist nicht vorhanden (wenn readOnlytrue ist).

- oder -

Die angegebene Kategorie ist keine benutzerdefinierte .NET Framework-Kategorie (wenn readOnlyfalse ist).

- oder -

Die angegebene Kategorie ist als Mehrfachinstanz gekennzeichnet und erfordert es, dass der Leistungsindikator mit einem Instanznamen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedenen Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

UnauthorizedAccessException

Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.

Hinweise

Bei den Parameterzeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

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

Diese Überladung des Konstruktors legt die CategoryNameEigenschaften , CounterNameund InstanceName auf die von Ihnen übergebenen Werte fest und legt die MachineName Eigenschaft auf den lokalen Computer "." fest.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet den instance einem vorhandenen Leistungsindikator (entweder einem System oder einem benutzerdefinierten Leistungsindikator) auf dem lokalen Computer zu. Die Werte, die Sie für die CategoryNameEigenschaften , CounterNameund übergeben, InstanceName müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen. Wenn der Leistungsindikator instance, auf den Sie verweisen, ungültig ist, löst das Aufrufen des Konstruktors eine Ausnahme aus.

Hinweis

Sie können diese Überladung verwenden, um eine Verbindung mit einem Systemindikator herzustellen, aber Sie können nicht in einen Systemindikator schreiben. Daher führt die Einstellung readOnly auf beim false Herstellen einer Verbindung mit einem Systemindikator dazu, dass der Konstruktor eine Ausnahme auslöst.

Um eine Leistungskategorie instance zu erstellen, geben Sie einen instanceName für den PerformanceCounter Konstruktor an. Wenn die von instanceName angegebene Kategorie instance bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorie instance.

Hinweis

Zum Lesen von Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 müssen Sie entweder Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.

Um zu vermeiden, dass Sie Ihre Berechtigungen für den Zugriff auf Leistungsindikatoren in Windows Vista erhöhen müssen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.

Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer auf den Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.

PerformanceCounter(String, String, String, String)

Quelle:

PerformanceCounter.cs

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.

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

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

new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

Parameter

categoryName

String

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

counterName

String

Der Name des Leistungsindikators.

instanceName

String

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

machineName

String

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

Ausnahmen

InvalidOperationException

categoryName ist eine leere Zeichenfolge ("").

- oder -

counterName ist eine leere Zeichenfolge ("").

- oder -

Die angeforderte Lese-/Schreibberechtigungseinstellung ist für diesen Indikator ungültig.

- oder -

Der Zähler ist auf dem angegebenen Computer nicht vorhanden.

- oder -

Die angegebene Kategorie ist als Mehrfachinstanz gekennzeichnet und erfordert es, dass der Leistungsindikator mit einem Instanznamen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedenen Sprachen lokalisiert.

ArgumentException

Der machineName-Parameter ist ungültig.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Beim Zugreifen auf eine System-API ist ein Fehler aufgetreten.

UnauthorizedAccessException

Ohne Administratorrechte ausgeführter Code hat versucht, einen Leistungsindikator zu lesen.

Hinweise

Bei den Parameterzeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

Diese Überladung des Konstruktors legt die CategoryNameEigenschaften , CounterName, InstanceNameund MachineName auf die Werte fest, die Sie übergeben.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet den instance einem vorhandenen Zähler (entweder einem System oder einem benutzerdefinierten Leistungsindikator) auf dem angegebenen Computer zu. Die Werte, die Sie für die CategoryNameEigenschaften , und InstanceNameMachineName übergeben, CounterNamemüssen auf einen vorhandenen Leistungsindikator verweisen. Wenn der Leistungsindikator instance, auf den Sie verweisen, ungültig ist, löst der Aufruf des Konstruktors eine Ausnahme aus. Diese Überladung kann auf jeden schreibgeschützten oder Lese-/Schreibindikator zugreifen, dies jedoch im schreibgeschützten Modus. Ein PerformanceCounter mit dieser Überladung erstelltes instance kann nicht in den Leistungsindikator schreiben, selbst wenn der Indikator selbst Lese-/Schreibzugriff hat.

Hinweis

Sie können nicht in Remoteleistungsindikatoren schreiben. Es gibt keine Überladung, mit der Sie einen Lese-/Schreibzugriff instance der Klasse angeben können, die PerformanceCounter eine Verbindung mit einem Remotecomputer herstellt.

Um eine Leistungskategorie instance zu erstellen, geben Sie eine für den PerformanceCounter Konstruktor aninstanceName. Wenn die von instanceName angegebene Kategorie instance bereits vorhanden ist, verweist das neue Objekt auf die vorhandene Kategorie instance.

Hinweis

Zum Lesen von Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 müssen Sie entweder Mitglied der Gruppe Leistungsmonitor Benutzer sein oder über Administratorrechte verfügen.

Um zu vermeiden, dass Sie Ihre Berechtigungen für den Zugriff auf Leistungsindikatoren in Windows Vista erhöhen müssen, fügen Sie sich der Gruppe Leistungsmonitor Benutzer hinzu.

Unter Windows Vista werden die Berechtigungen eines Benutzers über die Benutzerkontensteuerung (User Account Control, UAC) bestimmt. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Dazu starten Sie eine Anwendung, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie die Anwendung als Administrator ausführen möchten.

Hinweis

Wenn der Remotecomputer In Windows Vista Mitglied einer Arbeitsgruppe ist, müssen Sie UAC möglicherweise deaktivieren, damit das lokale Benutzerkonto nicht gefiltert wird und auf ein Administratorkonto erhöht werden kann. Aus Sicherheitsgründen sollte die Deaktivierung der UAC ein letzter Ausweg sein. Informationen zum Deaktivieren der Benutzerkontensteuerung finden Sie unter Benutzerkontensteuerung und WMI.