PerformanceCounter Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de PerformanceCounter klasse.
Overloads
| Name | Description |
|---|---|
| PerformanceCounter() |
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse, zonder het exemplaar te koppelen aan een systeem of aangepaste prestatiemeteritem. |
| PerformanceCounter(String, String) |
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem op de lokale computer. Deze constructor vereist dat de categorie één exemplaar heeft. |
| PerformanceCounter(String, String, Boolean) |
Initialiseert een nieuw, alleen-lezen of alleen-lezen/schrijven-exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem op de lokale computer. Deze constructor vereist dat de categorie één exemplaar bevat. |
| PerformanceCounter(String, String, String) |
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem en categorie-exemplaar op de lokale computer. |
| PerformanceCounter(String, String, String, Boolean) |
Initialiseert een nieuw exemplaar met het kenmerk Alleen-lezen of lezen/schrijven van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of het aangepaste prestatiemeteritem en het categorie-exemplaar op de lokale computer. |
| PerformanceCounter(String, String, String, String) |
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem en categorie-exemplaar op de opgegeven computer. |
PerformanceCounter()
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse, zonder het exemplaar te koppelen aan een systeem of aangepaste prestatiemeteritem.
public:
PerformanceCounter();public PerformanceCounter();Public Sub New ()Voorbeelden
In het volgende codevoorbeeld wordt een standaardexemplaren van de PerformanceCounter klasse gemaakt. Nadat het exemplaar is gemaakt, worden de CategoryName, CounterNameen InstanceName eigenschapswaarden ingesteld en worden de resultaten van een aanroep naar de NextValue methode weergegeven.
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())
Opmerkingen
Deze overbelasting van de constructor stelt de CategoryName, CounterNameen InstanceName eigenschappen in op lege tekenreeksen (""), en stelt de MachineName eigenschap in op de lokale computer,(".").
Deze constructor initialiseert het prestatiemeteritem niet, dus koppelt het exemplaar niet aan een bestaande teller op de lokale computer. Als u naar een specifiek prestatiemeteritem wilt verwijzen, stelt u de CategoryName, CounterNameen desgewenst de InstanceName en MachineName eigenschappen in voordat u andere eigenschappen leest of probeert te lezen vanuit een teller. Als u naar een prestatiemeteritem wilt schrijven, stelt u de ReadOnly eigenschap in op false.
Note
Het HostProtectionAttribute kenmerk dat op dit lid wordt toegepast, heeft de volgende Resources eigenschapswaarde:Synchronization | SharedState . Dit HostProtectionAttribute heeft geen invloed op bureaubladtoepassingen (die doorgaans worden gestart door te dubbelklikken op een pictogram, een opdracht te typen of een URL in een browser in te voeren). Zie de klasse HostProtectionAttribute of SQL Server Programming and Host Protection Attributes voor meer informatie.
Van toepassing op
PerformanceCounter(String, String)
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem op de lokale computer. Deze constructor vereist dat de categorie één exemplaar heeft.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);public PerformanceCounter(string categoryName, string counterName);new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounterPublic Sub New (categoryName As String, counterName As String)Parameters
- categoryName
- String
De naam van de prestatiemeteritemcategorie (prestatieobject) waaraan dit prestatiemeteritem is gekoppeld.
- counterName
- String
De naam van het prestatiemeteritem.
Uitzonderingen
categoryName is een lege tekenreeks ("").
– of –
counterName is een lege tekenreeks ("").
– of –
De opgegeven categorie bestaat niet.
– of –
De opgegeven categorie is gemarkeerd als meerdere exemplaren en vereist dat het prestatiemeteritems worden gemaakt met een exemplaarnaam.
– of –
categoryName en counterName zijn gelokaliseerd in verschillende talen.
categoryName of counterName is null.
Er is een fout opgetreden bij het openen van een systeem-API.
Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.
Opmerkingen
De parametertekenreeksen zijn niet hoofdlettergevoelig.
Gebruik deze overbelasting om toegang te krijgen tot een teller op de lokale computer die deel uitmaakt van een categorie met één exemplaar van de prestatiemeteritemcategorie. Als u deze constructor probeert te gebruiken om dit PerformanceCounter exemplaar te laten verwijzen naar een categorie die meerdere exemplaren bevat, genereert de constructor een uitzondering. Deze overbelasting heeft toegang tot elke teller met het kenmerk Alleen-lezen of lezen/schrijven, maar wel in een modus alleen-lezen. Een PerformanceCounter exemplaar dat met deze overbelasting wordt gemaakt, kan niet naar de teller schrijven, zelfs als het teller zelf lezen/schrijven is.
Deze overbelasting van de constructor stelt de CategoryName en CounterName eigenschappen in op de waarden die u doorgeeft, stelt de MachineName eigenschap in op de lokale computer, '.' en stelt de InstanceName eigenschap in op een lege tekenreeks ("").
Deze constructor initialiseert de prestatiemeteritem en koppelt het exemplaar aan een bestaand teller (een systeem of een aangepaste teller) op de lokale computer. De waarden die u voor de CategoryName en CounterName eigenschappen doorgeeft, moeten verwijzen naar een bestaand prestatiemeteritem op de lokale computer.
Note
Als u prestatiemeteritems wilt lezen van een niet-interactieve aanmeldingssessie in Windows Vista en hoger, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.
Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.
In Windows Vista bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.
Van toepassing op
PerformanceCounter(String, String, Boolean)
Initialiseert een nieuw, alleen-lezen of alleen-lezen/schrijven-exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem op de lokale computer. Deze constructor vereist dat de categorie één exemplaar bevat.
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.PerformanceCounterPublic Sub New (categoryName As String, counterName As String, readOnly As Boolean)Parameters
- categoryName
- String
De naam van de prestatiemeteritemcategorie (prestatieobject) waaraan dit prestatiemeteritem is gekoppeld.
- counterName
- String
De naam van het prestatiemeteritem.
- readOnly
- Boolean
true om toegang te krijgen tot de teller in de modus Alleen-lezen (hoewel de teller zelf lezen/schrijven kan zijn); false om toegang te krijgen tot de teller in de lees-/schrijfmodus.
Uitzonderingen
Het categoryName is een lege tekenreeks ("").
– of –
Het counterName is een lege tekenreeks ("").
– of –
De opgegeven categorie bestaat niet. (als readOnly dat het is true).
– of –
De opgegeven categorie is geen aangepaste .NET Framework-categorie (als readOnly is false).
– of –
De opgegeven categorie is gemarkeerd als meerdere exemplaren en vereist dat het prestatiemeteritems worden gemaakt met een exemplaarnaam.
– of –
categoryName en counterName zijn gelokaliseerd in verschillende talen.
categoryName of counterName is null.
Er is een fout opgetreden bij het openen van een systeem-API.
Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.
Voorbeelden
In het volgende codevoorbeeld wordt een exemplaar van de klasse PerformanceCounter gemaakt. In het voorbeeld worden categorienamen, tellernamen en een vlagwaarde doorgegeven die aangeeft dat de teller niet alleen-lezen is. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de PerformanceCounter klasse.
avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
"AverageCounter64Sample",
false);
avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)
Opmerkingen
De parametertekenreeksen zijn niet hoofdlettergevoelig.
Gebruik deze overbelasting voor toegang tot een alleen-lezen- of lees-/schrijfteller op de lokale computer die deel uitmaakt van een categorie met één exemplaar van de prestatiemeteritemcategorie. Als u deze constructor probeert te gebruiken om dit PerformanceCounter exemplaar te laten verwijzen naar een categorie die meerdere exemplaren bevat, genereert de constructor een uitzondering.
Deze overbelasting van de constructor stelt de CategoryName, CounterNameen ReadOnly eigenschappen in op de waarden die u doorgeeft, stelt de MachineName eigenschap in op de lokale computer, ".", en stelt de InstanceName eigenschap in op een lege tekenreeks ("").
Deze constructor initialiseert de prestatiemeteritem en koppelt het exemplaar aan een bestaand teller (een systeem of een aangepaste teller) op de lokale computer. De waarden die u voor de CategoryName en CounterName eigenschappen doorgeeft, moeten verwijzen naar een bestaand prestatiemeteritem op de lokale computer. Als het exemplaar van het prestatiemeteritem waarnaar u verwijst, ongeldig is, genereert het aanroepen van de constructor een uitzondering.
Note
U kunt deze overbelasting gebruiken om verbinding te maken met een systeemteller, maar u kunt niet naar een systeemteller schrijven. Daarom zorgt de instelling readOnly voor false het verbinden met een systeemteller ervoor dat de constructor een uitzondering genereert.
Note
Als u prestatiemeteritems wilt lezen van een niet-interactieve aanmeldingssessie in Windows Vista en hoger, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.
Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.
In Windows Vista bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.
Van toepassing op
PerformanceCounter(String, String, String)
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem en categorie-exemplaar op de lokale computer.
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.PerformanceCounterPublic Sub New (categoryName As String, counterName As String, instanceName As String)Parameters
- categoryName
- String
De naam van de prestatiemeteritemcategorie (prestatieobject) waaraan dit prestatiemeteritem is gekoppeld.
- counterName
- String
De naam van het prestatiemeteritem.
- instanceName
- String
De naam van het exemplaar van de prestatiemeteritemcategorie of een lege tekenreeks (""), als de categorie één exemplaar bevat.
Uitzonderingen
categoryName is een lege tekenreeks ("").
– of –
counterName is een lege tekenreeks ("").
– of –
De opgegeven categorie is ongeldig.
– of –
De opgegeven categorie is gemarkeerd als meerdere exemplaren en vereist dat het prestatiemeteritems worden gemaakt met een exemplaarnaam.
– of –
instanceName is langer dan 127 tekens.
– of –
categoryName en counterName zijn gelokaliseerd in verschillende talen.
categoryName of counterName is null.
Er is een fout opgetreden bij het openen van een systeem-API.
Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.
Opmerkingen
De parametertekenreeksen zijn niet hoofdlettergevoelig.
Deze overbelasting van de constructor stelt de CategoryName, CounterNameen InstanceName eigenschappen in op de waarden die u doorgeeft, en stelt de MachineName eigenschap in op de lokale computer, ".".
Deze constructor initialiseert de prestatiemeteritem en koppelt het exemplaar aan een bestaand teller (een systeem of een aangepaste teller) op de lokale computer. De waarden die u doorgeeft voor de CategoryName, CounterNameen InstanceName eigenschappen moeten verwijzen naar een bestaand prestatiemeteritem op de lokale computer. Als het exemplaar van het prestatiemeteritem waarnaar u verwijst niet geldig is, genereert het aanroepen van de constructor een uitzondering.
Deze overbelasting heeft toegang tot elke teller met het kenmerk Alleen-lezen of lezen/schrijven, maar wel in een modus alleen-lezen. Een PerformanceCounter exemplaar dat met deze overbelasting wordt gemaakt, kan niet naar de teller schrijven, zelfs als het teller zelf lezen/schrijven is.
Als u een exemplaar van een prestatiecategorie wilt maken, geeft u een instanceName op de PerformanceCounter constructor op. Als het categorie-exemplaar dat is opgegeven door instanceName al bestaat, verwijst het nieuwe object naar het bestaande categorie-exemplaar.
Note
Als u prestatiemeteritems wilt lezen in Windows Vista, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.
Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.
In Windows Vista bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.
Van toepassing op
PerformanceCounter(String, String, String, Boolean)
Initialiseert een nieuw exemplaar met het kenmerk Alleen-lezen of lezen/schrijven van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of het aangepaste prestatiemeteritem en het categorie-exemplaar op de lokale computer.
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.PerformanceCounterPublic Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)Parameters
- categoryName
- String
De naam van de prestatiemeteritemcategorie (prestatieobject) waaraan dit prestatiemeteritem is gekoppeld.
- counterName
- String
De naam van het prestatiemeteritem.
- instanceName
- String
De naam van het exemplaar van de prestatiemeteritemcategorie of een lege tekenreeks (""), als de categorie één exemplaar bevat.
- readOnly
- Boolean
true om toegang te krijgen tot een teller in de modus Alleen-lezen; false om toegang te krijgen tot een teller in de lees-/schrijfmodus.
Uitzonderingen
categoryName is een lege tekenreeks ("").
– of –
counterName is een lege tekenreeks ("").
– of –
De aangevraagde machtigingsinstelling voor lezen/schrijven is ongeldig voor dit teller.
– of –
De opgegeven categorie bestaat niet (indien readOnly aanwezig true).
– of –
De opgegeven categorie is geen aangepaste .NET Framework-categorie (als readOnly is false).
– of –
De opgegeven categorie is gemarkeerd als meerdere exemplaren en vereist dat het prestatiemeteritems worden gemaakt met een exemplaarnaam.
– of –
instanceName is langer dan 127 tekens.
– of –
categoryName en counterName zijn gelokaliseerd in verschillende talen.
categoryName of counterName is null.
Er is een fout opgetreden bij het openen van een systeem-API.
Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.
Opmerkingen
De parametertekenreeksen zijn niet hoofdlettergevoelig.
Gebruik deze overbelasting om toegang te krijgen tot een prestatiemeteritem in de modus Alleen-lezen of Lezen/schrijven.
Deze overbelasting van de constructor stelt de CategoryName, CounterNameen InstanceName eigenschappen in op de waarden die u doorgeeft, en stelt de MachineName eigenschap in op de lokale computer, '.'.
Deze constructor initialiseert de prestatiemeteritem en koppelt het exemplaar aan een bestaand teller (een systeem of een aangepaste teller) op de lokale computer. De waarden die u doorgeeft voor de CategoryName, CounterNameen InstanceName eigenschappen moeten verwijzen naar een bestaand prestatiemeteritem op de lokale computer. Als het exemplaar van het prestatiemeteritem waarnaar u verwijst, ongeldig is, genereert het aanroepen van de constructor een uitzondering.
Note
U kunt deze overbelasting gebruiken om verbinding te maken met een systeemteller, maar u kunt niet naar een systeemteller schrijven. Daarom zorgt de instelling readOnly voor false het verbinden met een systeemteller ervoor dat de constructor een uitzondering genereert.
Als u een exemplaar van een prestatiecategorie wilt maken, geeft u een instanceName op de PerformanceCounter constructor op. Als het categorie-exemplaar dat is opgegeven door instanceName al bestaat, verwijst het nieuwe object naar het bestaande categorie-exemplaar.
Note
Als u prestatiemeteritems wilt lezen in Windows Vista, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.
Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.
In Windows Vista bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.
Van toepassing op
PerformanceCounter(String, String, String, String)
Initialiseert een nieuw, alleen-lezen exemplaar van de PerformanceCounter klasse en koppelt deze aan het opgegeven systeem of aangepaste prestatiemeteritem en categorie-exemplaar op de opgegeven computer.
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.PerformanceCounterPublic Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)Parameters
- categoryName
- String
De naam van de prestatiemeteritemcategorie (prestatieobject) waaraan dit prestatiemeteritem is gekoppeld.
- counterName
- String
De naam van het prestatiemeteritem.
- instanceName
- String
De naam van het exemplaar van de prestatiemeteritemcategorie of een lege tekenreeks (""), als de categorie één exemplaar bevat.
- machineName
- String
De computer waarop de prestatiemeteritem en de bijbehorende categorie bestaan.
Uitzonderingen
categoryName is een lege tekenreeks ("").
– of –
counterName is een lege tekenreeks ("").
– of –
De aangevraagde machtigingsinstelling voor lezen/schrijven is ongeldig voor dit teller.
– of –
De teller bestaat niet op de opgegeven computer.
– of –
De opgegeven categorie is gemarkeerd als meerdere exemplaren en vereist dat het prestatiemeteritems worden gemaakt met een exemplaarnaam.
– of –
instanceName is langer dan 127 tekens.
– of –
categoryName en counterName zijn gelokaliseerd in verschillende talen.
De machineName parameter is ongeldig.
categoryName of counterName is null.
Er is een fout opgetreden bij het openen van een systeem-API.
Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.
Opmerkingen
De parametertekenreeksen zijn niet hoofdlettergevoelig.
Deze overbelasting van de constructor stelt de CategoryName, CounterNameen InstanceNameMachineName eigenschappen in op de waarden die u doorgeeft.
Met deze constructor wordt de prestatiemeteritem geïnitialiseerd en wordt het exemplaar gekoppeld aan een bestaande teller (een systeem of een aangepaste teller) op de opgegeven computer. De waarden die u doorgeeft voor de CategoryName, CounterNameInstanceName en MachineName eigenschappen moeten verwijzen naar een bestaand prestatiemeteritem. Als het exemplaar van het prestatiemeteritem waarnaar u verwijst niet geldig is, genereert het aanroepen van de constructor een uitzondering. Deze overbelasting heeft toegang tot elke teller met het kenmerk Alleen-lezen of lezen/schrijven, maar wel in een modus alleen-lezen. Een PerformanceCounter exemplaar dat met deze overbelasting wordt gemaakt, kan niet naar de teller schrijven, zelfs als het teller zelf lezen/schrijven is.
Note
U kunt niet schrijven naar externe prestatiemeteritems. Er is geen overbelasting waarmee u een exemplaar van lezen/schrijven kunt opgeven van de PerformanceCounter klasse die verbinding maakt met een externe computer.
Als u een exemplaar van een prestatiecategorie wilt maken, geeft u een instanceName op de PerformanceCounter constructor op. Als het categorie-exemplaar dat is opgegeven door instanceName al bestaat, verwijst het nieuwe object naar het bestaande categorie-exemplaar.
Note
Als u prestatiemeteritems wilt lezen in Windows Vista, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.
Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.
In Windows Vista bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.
Note
Wanneer de externe computer lid is van een werkgroep, moet u in Windows Vista mogelijk UAC uitschakelen, zodat het lokale gebruikersaccount niet wordt gefilterd en kan worden verhoogd naar een beheerdersaccount. Om veiligheidsredenen moet het uitschakelen van UAC een laatste redmiddel zijn. Zie Gebruikersaccountbeheer en WMI voor meer informatie over het uitschakelen van UAC.
