PerformanceCounter Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Initialisiert eine neue Instanz der PerformanceCounter-Klasse.

Überlädt

Name	Beschreibung
PerformanceCounter()	Initialisiert eine neue schreibgeschützte Instanz der PerformanceCounter Klasse, ohne die 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. Dieser Konstruktor erfordert, dass die Kategorie über eine einzelne Instanz verfügt.
PerformanceCounter(String, String, Boolean)	Initialisiert eine neue, schreibgeschützte oder schreibgeschützte Instanz der PerformanceCounter Klasse und ordnet sie dem angegebenen System oder benutzerdefinierten Leistungsindikator auf dem lokalen Computer zu. Dieser Konstruktor erfordert, dass die Kategorie eine einzelne Instanz enthält.
PerformanceCounter(String, String, String)	Initialisiert eine neue schreibgeschützte Instanz der PerformanceCounter Klasse und ordnet sie dem angegebenen System oder benutzerdefinierten Leistungsindikator und der Kategorieinstanz auf dem lokalen Computer zu.
PerformanceCounter(String, String, String, Boolean)	Initialisiert eine neue, schreibgeschützte oder schreibgeschützte Instanz der PerformanceCounter Klasse und ordnet sie dem angegebenen System oder der benutzerdefinierten Leistungsindikator- und 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 der benutzerdefinierten Leistungsindikator- und Kategorieinstanz auf dem angegebenen Computer zu.

PerformanceCounter()

Quelle:

PerformanceCounter.cs

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

public:
 PerformanceCounter();

public PerformanceCounter();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird eine Standardinstanz der PerformanceCounter Klasse erstellt. Nachdem die Instanz erstellt wurde, werden die CategoryNameWerte CounterNameund InstanceName Eigenschaftswerte festgelegt, und die Ergebnisse eines Aufrufs der NextValue Methode werden angezeigt.

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 CounterNameCategoryNameZeichenfolgen und Eigenschaften auf leere Zeichenfolgen ("") fest InstanceName und legt die MachineName Eigenschaft auf den lokalen Computer (".").

Dieser Konstruktor initialisiert den Leistungsindikator nicht, sodass die Instanz keinem vorhandenen Zähler auf dem lokalen Computer zugeordnet wird. Um auf einen bestimmten Leistungsindikator zu verweisen, legen Sie das CategoryName, CounterNameund optional die InstanceName Eigenschaften und MachineName Eigenschaften fest, bevor Sie andere Eigenschaften lesen oder versuchen, aus einem Zähler zu lesen. Um in einen Leistungsindikator zu schreiben, legen Sie die ReadOnly Eigenschaft auf false.

Hinweis

Das HostProtectionAttribute Attribut, das auf dieses Element angewendet wird, weist den folgenden Resources Eigenschaftswert auf: | SynchronizationSharedState . Dies HostProtectionAttribute wirkt sich nicht auf Desktopanwendungen aus (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder Eingeben einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie in der Klasse oder sql HostProtectionAttributeServer Programming and Host Protection Attributes.

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. Dieser Konstruktor erfordert, dass die Kategorie über eine einzelne Instanz verfügt.

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 (Leistungsobjekt), 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 multi-instance gekennzeichnet und erfordert, dass der Leistungsindikator mit einem instance Namen erstellt wird.

- oder -

categoryName und counterName wurden in verschiedene Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Fehler beim Zugriff auf eine System-API.

UnauthorizedAccessException

Code, der ohne Administratorrechte ausgeführt wird, hat versucht, einen Leistungsindikator zu lesen.

Hinweise

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

Verwenden Sie diese Überladung, um auf einen Zähler auf dem lokalen Computer zuzugreifen, der zu einer Kategorie gehört, die eine einzige Instanz der Leistungsindikatorkategorie enthält. Wenn Sie versuchen, diesen Konstruktor zu verwenden, um diese PerformanceCounter Instanz 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-/schreibgeschützten Zähler zugreifen. Dies erfolgt jedoch im schreibgeschützten Modus. Eine PerformanceCounter mit dieser Überladung erstellte Instanz kann nicht in den Zähler schreiben, auch wenn der Zähler selbst lese-/schreibgeschützt ist.

Diese Überladung des Konstruktors legt die CategoryName werte CounterName , die Sie übergeben, die MachineName Eigenschaft auf den lokalen Computer "." und legt die InstanceName Eigenschaft auf eine leere Zeichenfolge ("") fest.

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

Hinweis

Um Leistungsindikatoren aus einer nicht interaktiven Anmeldesitzung in Windows Vista und höher, Windows XP Professional x64 Edition oder Windows Server 2003 zu lesen, müssen Sie entweder Mitglied der Gruppe "Benutzer der Leistungsüberwachung" 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 "Benutzer der Leistungsüberwachung" hinzu.

In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie als Administrator ausführen möchten.

PerformanceCounter(String, String, Boolean)

Quelle:

PerformanceCounter.cs

Initialisiert eine neue, schreibgeschützte oder schreibgeschützte Instanz der PerformanceCounter Klasse und ordnet sie dem angegebenen System oder benutzerdefinierten Leistungsindikator auf dem lokalen Computer zu. Dieser Konstruktor erfordert, dass die Kategorie eine einzelne Instanz enthält.

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 (Leistungsobjekt), der dieser Leistungsindikator zugeordnet ist.

counterName

String

Der Name des Leistungsindikators.

readOnly

Boolean

true um im schreibgeschützten Modus auf den Zähler zuzugreifen (obwohl der Zähler selbst lese-/schreibgeschützt sein könnte); false um im Lese-/Schreibmodus auf den Leistungsindikator zuzugreifen.

Ausnahmen

InvalidOperationException

Dies categoryName ist eine leere Zeichenfolge ("").

- oder -

Dies counterName ist eine leere Zeichenfolge ("").

- oder -

Die angegebene Kategorie ist nicht vorhanden. (falls readOnly vorhanden).true

- oder -

Die angegebene Kategorie ist keine benutzerdefinierte .NET Framework-Kategorie (falls readOnly vorhanden false).

- oder -

Die angegebene Kategorie ist als multi-instance gekennzeichnet und erfordert, dass der Leistungsindikator mit einem instance Namen erstellt wird.

- oder -

categoryName und counterName wurden in verschiedene Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Fehler beim Zugriff auf eine System-API.

UnauthorizedAccessException

Code, der ohne Administratorrechte ausgeführt wird, hat versucht, einen Leistungsindikator zu lesen.

Beispiele

Im folgenden Codebeispiel wird eine Instanz 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.

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 Lese-/Schreibzähler auf dem lokalen Computer zuzugreifen, der zu einer Kategorie gehört, die eine einzige Instanz der Leistungsindikatorkategorie enthält. Wenn Sie versuchen, diesen Konstruktor zu verwenden, um diese PerformanceCounter Instanz auf eine Kategorie zu verweisen, die mehrere Instanzen enthält, löst der Konstruktor eine Ausnahme aus.

Diese Überladung des Konstruktors legt die CategoryNameCounterNamewerte, die Sie übergeben, MachineName die Eigenschaft auf den lokalen Computer "." fest ReadOnly und legt die InstanceName Eigenschaft auf eine leere Zeichenfolge ("").

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet die Instanz einem vorhandenen Zähler (entweder einem System oder einem benutzerdefinierten Zähler) auf dem lokalen Computer zu. Die Werte, die Sie für die und CounterName die CategoryName Eigenschaften übergeben, müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen. Wenn die Instanz des Leistungsindikators, auf die 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 Systemzähler herzustellen, aber sie können nicht in einen Systemzähler schreiben. Die Einstellung readOnlyfalse beim Herstellen einer Verbindung mit einem Systemzähler bewirkt daher, dass der Konstruktor eine Ausnahme auslöst.

Hinweis

Um Leistungsindikatoren aus einer nicht interaktiven Anmeldesitzung in Windows Vista und höher, Windows XP Professional x64 Edition oder Windows Server 2003 zu lesen, müssen Sie entweder Mitglied der Gruppe "Benutzer der Leistungsüberwachung" 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 "Benutzer der Leistungsüberwachung" hinzu.

In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie 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 und der 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 (Leistungsobjekt), der dieser Leistungsindikator zugeordnet ist.

counterName

String

Der Name des Leistungsindikators.

instanceName

String

Der Name der Kategorieinstanz des Leistungsindikators 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 multi-instance gekennzeichnet und erfordert, dass der Leistungsindikator mit einem instance Namen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedene Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Fehler beim Zugriff auf eine System-API.

UnauthorizedAccessException

Code, der ohne Administratorrechte ausgeführt wird, hat versucht, einen Leistungsindikator zu lesen.

Hinweise

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

Diese Überladung des Konstruktors legt die CategoryNameWerte CounterName, die Sie übergeben, und InstanceName die MachineName Eigenschaft wird auf den lokalen Computer "." festgelegt.

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

Diese Überladung kann auf jeden schreibgeschützten oder lese-/schreibgeschützten Zähler zugreifen. Dies erfolgt jedoch im schreibgeschützten Modus. Eine PerformanceCounter mit dieser Überladung erstellte Instanz kann nicht in den Zähler schreiben, auch wenn der Zähler selbst lese-/schreibgeschützt ist.

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

Hinweis

Um Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 zu lesen, müssen Sie entweder Mitglied der Gruppe "Benutzer der Leistungsüberwachung" 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 "Benutzer der Leistungsüberwachung" hinzu.

In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie als Administrator ausführen möchten.

PerformanceCounter(String, String, String, Boolean)

Quelle:

PerformanceCounter.cs

Initialisiert eine neue, schreibgeschützte oder schreibgeschützte Instanz der PerformanceCounter Klasse und ordnet sie dem angegebenen System oder der benutzerdefinierten Leistungsindikator- und 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 (Leistungsobjekt), der dieser Leistungsindikator zugeordnet ist.

counterName

String

Der Name des Leistungsindikators.

instanceName

String

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

readOnly

Boolean

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

Ausnahmen

InvalidOperationException

categoryName ist eine leere Zeichenfolge ("").

- oder -

counterName ist eine leere Zeichenfolge ("").

- oder -

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

- oder -

Die angegebene Kategorie ist nicht vorhanden (falls readOnly vorhanden true).

- oder -

Die angegebene Kategorie ist keine benutzerdefinierte .NET Framework-Kategorie (falls readOnly vorhanden false).

- oder -

Die angegebene Kategorie ist als multi-instance gekennzeichnet und erfordert, dass der Leistungsindikator mit einem instance Namen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedene Sprachen lokalisiert.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Fehler beim Zugriff auf eine System-API.

UnauthorizedAccessException

Code, der ohne Administratorrechte ausgeführt wird, hat versucht, einen Leistungsindikator zu lesen.

Hinweise

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

Verwenden Sie diese Überladung, um im Schreib-/Schreibmodus auf einen Leistungsindikator zuzugreifen.

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

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet die Instanz einem vorhandenen Zähler (entweder einem System oder einem benutzerdefinierten Zähler) auf dem lokalen Computer zu. Die Werte, die Sie für das CategoryName, CounterNameund InstanceName die Eigenschaften übergeben, müssen auf einen vorhandenen Leistungsindikator auf dem lokalen Computer verweisen. Wenn die Instanz des Leistungsindikators, auf die 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 Systemzähler herzustellen, aber sie können nicht in einen Systemzähler schreiben. Die Einstellung readOnlyfalse beim Herstellen einer Verbindung mit einem Systemzähler bewirkt daher, dass der Konstruktor eine Ausnahme auslöst.

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

Hinweis

Um Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 zu lesen, müssen Sie entweder Mitglied der Gruppe "Benutzer der Leistungsüberwachung" 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 "Benutzer der Leistungsüberwachung" hinzu.

In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie 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 der benutzerdefinierten Leistungsindikator- und 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 (Leistungsobjekt), der dieser Leistungsindikator zugeordnet ist.

counterName

String

Der Name des Leistungsindikators.

instanceName

String

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

machineName

String

Der Computer, auf dem der Leistungsindikator und die zugehörige 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 Leistungsindikator ungültig.

- oder -

Der Leistungsindikator ist auf dem angegebenen Computer nicht vorhanden.

- oder -

Die angegebene Kategorie ist als multi-instance gekennzeichnet und erfordert, dass der Leistungsindikator mit einem instance Namen erstellt wird.

- oder -

instanceName ist länger als 127 Zeichen.

- oder -

categoryName und counterName wurden in verschiedene Sprachen lokalisiert.

ArgumentException

Der machineName Parameter ist ungültig.

ArgumentNullException

categoryName oder counterName ist null.

Win32Exception

Fehler beim Zugriff auf eine System-API.

UnauthorizedAccessException

Code, der ohne Administratorrechte ausgeführt wird, hat versucht, einen Leistungsindikator zu lesen.

Hinweise

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

Diese Überladung des Konstruktors legt die CategoryNamewerte fest, MachineNameCounterNameInstanceNamedie Sie übergeben.

Dieser Konstruktor initialisiert den Leistungsindikator und ordnet die Instanz einem vorhandenen Zähler (entweder einem System oder einem benutzerdefinierten Zähler) auf dem angegebenen Computer zu. Die Werte, die Sie für das CategoryName, CounterNameund MachineName die Eigenschaften übergeben werden, InstanceName müssen auf einen vorhandenen Leistungsindikator verweisen. Wenn die Instanz des Leistungsindikators, auf die Sie verweisen, ungültig ist, löst das Aufrufen des Konstruktors eine Ausnahme aus. Diese Überladung kann auf jeden schreibgeschützten oder lese-/schreibgeschützten Zähler zugreifen. Dies erfolgt jedoch im schreibgeschützten Modus. Eine PerformanceCounter mit dieser Überladung erstellte Instanz kann nicht in den Zähler schreiben, auch wenn der Zähler selbst lese-/schreibgeschützt ist.

Hinweis

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

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

Hinweis

Um Leistungsindikatoren in Windows Vista, Windows XP Professional x64 Edition oder Windows Server 2003 zu lesen, müssen Sie entweder Mitglied der Gruppe "Benutzer der Leistungsüberwachung" 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 "Benutzer der Leistungsüberwachung" hinzu.

In Windows Vista bestimmt die Benutzerkontensteuerung (User Account Control, UAC) die Berechtigungen eines Benutzers. Wenn Sie Mitglied der Gruppe "Integrierte Administratoren" sind, werden Ihnen zwei Laufzeitzugriffstoken zugewiesen: ein Standardbenutzerzugriffstoken und ein Administratorzugriffstoken. Standardmäßig befinden Sie sich in der Standardbenutzerrolle. Um den Code auszuführen, der auf Leistungsindikatoren zugreift, müssen Sie zuerst Ihre Berechtigungen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie mit der rechten Maustaste auf das Anwendungssymbol klicken und angeben, dass Sie als Administrator ausführen möchten.

Hinweis

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