PerformanceCounter Konstruktorok

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.PerformanceCounter.dll

Csomag:

System.Diagnostics.PerformanceCounter v11.0.0-preview.7.26381.103

Inicializálja a PerformanceCounter osztály új példányát.

Túlterhelések

Name	Description
PerformanceCounter()	Inicializálja az PerformanceCounter osztály új, írásvédett példányát anélkül, hogy a példányt bármilyen rendszer- vagy egyéni teljesítményszámlálóhoz társítanák.
PerformanceCounter(String, String)	Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóval. Ez a konstruktor megköveteli, hogy a kategória egyetlen példánysal rendelkezzen.
PerformanceCounter(String, String, Boolean)	Inicializálja az PerformanceCounter osztály új, írásvédett vagy írási/olvasási példányát, és társítja a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóval. Ez a konstruktor megköveteli, hogy a kategória egyetlen példányt tartalmazzon.
PerformanceCounter(String, String, String)	Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja azt a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóhoz és kategóriapéldányhoz.
PerformanceCounter(String, String, String, Boolean)	Inicializálja az PerformanceCounter osztály új, írásvédett vagy írásvédett példányát, és társítja azt a helyi számítógép megadott rendszer- vagy egyéni teljesítményszámlálójával és kategóriapéldányával.
PerformanceCounter(String, String, String, String)	Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja azt a megadott rendszer- vagy egyéni teljesítményszámlálóhoz és kategóriapéldányhoz a megadott számítógépen.

PerformanceCounter()

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett példányát anélkül, hogy a példányt bármilyen rendszer- vagy egyéni teljesítményszámlálóhoz társítanák.

public:
 PerformanceCounter();

public PerformanceCounter();

Public Sub New ()

Példák

Az alábbi példakód az osztály alapértelmezett példányát PerformanceCounter hozza létre. A példány létrehozása után a rendszer beállítja a CategoryName, CounterNameés InstanceName a tulajdonság értékeit, és megjelenik a NextValue metódus hívásának eredménye.

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())

Megjegyzések

A konstruktor túlterhelése üres sztringek ("") értékre állítja a CategoryName, CounterNameés InstanceName tulajdonságokat, és beállítja a MachineName tulajdonságot a helyi számítógépre (".").

Ez a konstruktor nem inicializálja a teljesítményszámlálót, ezért nem társítja a példányt egy meglévő számlálóval a helyi számítógépen. Ha egy adott teljesítményszámlálóra szeretne rámutatni, állítsa be a CategoryName, CounterNameés , opcionálisan az és InstanceName a MachineName tulajdonságokat, mielőtt bármilyen más tulajdonságot olvas, vagy megpróbál olvasni egy számlálóból. Teljesítményszámlálóba való íráshoz állítsa a tulajdonságot a ReadOnly következőre false: .

Note

A HostProtectionAttribute tagra alkalmazott attribútum a következő Resources tulajdonságértéket tartalmazza: Synchronization | SharedState. Ez HostProtectionAttribute nem érinti az asztali alkalmazásokat (amelyek általában egy ikonra duplán kattintva, egy parancs beírásával vagy egy URL-cím beírásával indulnak el a böngészőben). További információ: HostProtectionAttribute osztály vagy SQL Server Programozási és gazdagépvédelmi attribútumok.

PerformanceCounter(String, String)

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóval. Ez a konstruktor megköveteli, hogy a kategória egyetlen példánysal rendelkezzen.

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)

Paraméterek

categoryName

String

Annak a teljesítményszámláló-kategóriának (teljesítményobjektumnak) a neve, amelyhez ez a teljesítményszámláló társítva van.

counterName

String

A teljesítményszámláló neve.

Kivételek

InvalidOperationException

categoryName üres sztring ("").

-vagy-

counterName üres sztring ("").

-vagy-

A megadott kategória nem létezik.

-vagy-

A megadott kategória többpéldányosként van megjelölve, és megköveteli, hogy a teljesítményszámlálót példánynévvel hozza létre.

-vagy-

categoryName és counterName különböző nyelvekre lettek honosítva.

ArgumentNullException

categoryName vagy counterName az null.

Win32Exception

Hiba történt egy rendszer API elérésekor.

UnauthorizedAccessException

A rendszergazdai jogosultságok nélkül végrehajtó kód megkísérelt beolvasni egy teljesítményszámlálót.

Megjegyzések

A paramétersztringek nem megkülönböztetik a kis- és nagybetűket.

Ezzel a túlterheléssel hozzáférhet egy számlálóhoz a helyi számítógépen, amely egyetlen teljesítményszámláló kategóriapéldányt tartalmazó kategóriához tartozik. Ha ezt a konstruktort arra próbálja használni, hogy a PerformanceCounter példányt egy több példányt tartalmazó kategóriára mutasson, a konstruktor kivételt jelez. Ez a túlterhelés bármilyen írásvédett vagy írási/olvasási számlálóhoz hozzáfér, de ezt írásvédett módban teszi. Az PerformanceCounter ezzel a túlterheléssel létrehozott példány nem tud írni a számlálóba, még akkor sem, ha maga a számláló olvasható/írható.

A konstruktor túlterhelése a CategoryNameCounterName megadott értékekre állítja a tulajdonságokat, a MachineName tulajdonságot a helyi számítógépre állítja, ".", és a InstanceName tulajdonságot egy üres sztringre ("") állítja be.

Ez a konstruktor inicializálja a teljesítményszámlálót, és társítja a példányt egy meglévő számlálóval (rendszer vagy egyéni számláló) a helyi számítógépen. A megadott értékeknek és CategoryName tulajdonságoknak a CounterName helyi számítógépen egy meglévő teljesítményszámlálóra kell mutatniuk.

Note

Ha teljesítményszámlálókat szeretne olvasni egy nem interaktív bejelentkezési munkamenetből Windows Vista és újabb verziókban, Windows XP Professional x64 Edition vagy Windows Server 2003-ban, akkor vagy a Performance Monitor Felhasználók csoport tagjának kell lennie, vagy rendszergazdai jogosultságokkal kell rendelkeznie.

Ha el szeretné kerülni, hogy emelje a jogosultságait a teljesítményszámlálókhoz való hozzáféréshez a Windows Vista, vegye fel magát a Performance Monitor Felhasználók csoportba.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A teljesítményszámlálókhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

PerformanceCounter(String, String, Boolean)

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett vagy írási/olvasási példányát, és társítja a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóval. Ez a konstruktor megköveteli, hogy a kategória egyetlen példányt tartalmazzon.

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)

Paraméterek

categoryName

String

Annak a teljesítményszámláló-kategóriának (teljesítményobjektumnak) a neve, amelyhez ez a teljesítményszámláló társítva van.

counterName

String

A teljesítményszámláló neve.

readOnly

Boolean

true a számláló írásvédett módban való elérése (bár maga a számláló is lehet olvasás/írás); false a számláló olvasási/írási módban való eléréséhez.

Kivételek

InvalidOperationException

Ez categoryName egy üres sztring ("").

-vagy-

Ez counterName egy üres sztring ("").

-vagy-

A megadott kategória nem létezik. (ha readOnly van true).

-vagy-

A megadott kategória nem egyéni .NET keretrendszer kategória (ha readOnlyfalse).

-vagy-

A megadott kategória többpéldányosként van megjelölve, és megköveteli, hogy a teljesítményszámlálót példánynévvel hozza létre.

-vagy-

categoryName és counterName különböző nyelvekre lettek honosítva.

ArgumentNullException

categoryName vagy counterName az null.

Win32Exception

Hiba történt egy rendszer API elérésekor.

UnauthorizedAccessException

A rendszergazdai jogosultságok nélkül végrehajtó kód megkísérelt beolvasni egy teljesítményszámlálót.

Példák

Az alábbi példakód a PerformanceCounter osztály egy példányát hozza létre. A példa kategórianevekben, számlálónevekben és jelölőértékben jelenik meg, amely azt jelzi, hogy a számláló nem írásvédett. Ez a példakód az osztály egy nagyobb példájának PerformanceCounter része.

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

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

Megjegyzések

A paramétersztringek nem megkülönböztetik a kis- és nagybetűket.

Ezzel a túlterheléssel hozzáférhet egy írásvédett vagy írási/olvasási számlálóhoz a helyi számítógépen, amely egyetlen teljesítményszámláló kategóriapéldányt tartalmazó kategóriához tartozik. Ha ezt a konstruktort arra próbálja használni, hogy a PerformanceCounter példányt egy több példányt tartalmazó kategóriára mutasson, a konstruktor kivételt jelez.

A konstruktor túlterhelése a CategoryNamemegadott értékekre állítja a , CounterNameés ReadOnly a tulajdonságokat, a MachineName tulajdonságot a helyi számítógépre állítja,".", és a InstanceName tulajdonságot egy üres sztringre ("") állítja be.

Ez a konstruktor inicializálja a teljesítményszámlálót, és társítja a példányt egy meglévő számlálóval (rendszer vagy egyéni számláló) a helyi számítógépen. A megadott értékeknek és CategoryName tulajdonságoknak a CounterName helyi számítógépen egy meglévő teljesítményszámlálóra kell mutatniuk. Ha a teljesítményszámláló által jelzett példány érvénytelen, a konstruktor meghívása kivételt eredményez.

Note

Ezzel a túlterheléssel csatlakozhat egy rendszerszámlálóhoz, de nem írhat rendszerszámlálóba. Ezért a readOnlyfalse rendszerszámlálóhoz való csatlakozáskor a konstruktor kivételt okoz.

Note

Ha teljesítményszámlálókat szeretne olvasni egy nem interaktív bejelentkezési munkamenetből Windows Vista és újabb verziókban, Windows XP Professional x64 Edition vagy Windows Server 2003-ban, akkor vagy a Performance Monitor Felhasználók csoport tagjának kell lennie, vagy rendszergazdai jogosultságokkal kell rendelkeznie.

Ha el szeretné kerülni, hogy emelje a jogosultságait a teljesítményszámlálókhoz való hozzáféréshez a Windows Vista, vegye fel magát a Performance Monitor Felhasználók csoportba.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A teljesítményszámlálókhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

PerformanceCounter(String, String, String)

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja azt a helyi számítógépen megadott rendszer- vagy egyéni teljesítményszámlálóhoz és kategóriapéldányhoz.

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)

Paraméterek

categoryName

String

Annak a teljesítményszámláló-kategóriának (teljesítményobjektumnak) a neve, amelyhez ez a teljesítményszámláló társítva van.

counterName

String

A teljesítményszámláló neve.

instanceName

String

A teljesítményszámláló kategóriapéldányának neve vagy egy üres sztring (""), ha a kategória egyetlen példányt tartalmaz.

Kivételek

InvalidOperationException

categoryName üres sztring ("").

-vagy-

counterName üres sztring ("").

-vagy-

A megadott kategória érvénytelen.

-vagy-

A megadott kategória többpéldányosként van megjelölve, és megköveteli, hogy a teljesítményszámlálót példánynévvel hozza létre.

-vagy-

instanceName 127 karakternél hosszabb.

-vagy-

categoryName és counterName különböző nyelvekre lettek honosítva.

ArgumentNullException

categoryName vagy counterName az null.

Win32Exception

Hiba történt egy rendszer API elérésekor.

UnauthorizedAccessException

A rendszergazdai jogosultságok nélkül végrehajtó kód megkísérelt beolvasni egy teljesítményszámlálót.

Megjegyzések

A paramétersztringek nem megkülönböztetik a kis- és nagybetűket.

A konstruktor túlterhelése a CategoryNamemegadott értékekre állítja a , CounterNameés InstanceName a tulajdonságokat, és beállítja a MachineName tulajdonságot a helyi számítógép "." értékére.

Ez a konstruktor inicializálja a teljesítményszámlálót, és társítja a példányt egy meglévő számlálóval (rendszer vagy egyéni számláló) a helyi számítógépen. A , CategoryNameés CounterName a tulajdonságok számára InstanceNameátadott értékeknek a helyi számítógépen meglévő teljesítményszámlálóra kell mutatniuk. Ha a teljesítményszámláló által jelzett példány érvénytelen, a konstruktor meghívása kivételt eredményez.

Ez a túlterhelés bármilyen írásvédett vagy írási/olvasási számlálóhoz hozzáfér, de ezt írásvédett módban teszi. Az PerformanceCounter ezzel a túlterheléssel létrehozott példány nem tud írni a számlálóba, még akkor sem, ha maga a számláló olvasható/írható.

Teljesítménykategória-példány létrehozásához adjon meg egy instanceName konstruktort PerformanceCounter . Ha a megadott instanceName kategóriapéldány már létezik, az új objektum a meglévő kategóriapéldányra hivatkozik.

Note

A teljesítményszámlálók Windows Vista, Windows XP Professional x64 Edition vagy 2003-Windows Server olvasásához vagy a Performance Monitor Felhasználók csoport tagjának kell lennie, vagy rendszergazdai jogosultságokkal kell rendelkeznie.

Ha el szeretné kerülni, hogy emelje a jogosultságait a teljesítményszámlálókhoz való hozzáféréshez a Windows Vista, vegye fel magát a Performance Monitor Felhasználók csoportba.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A teljesítményszámlálókhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

PerformanceCounter(String, String, String, Boolean)

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett vagy írásvédett példányát, és társítja azt a helyi számítógép megadott rendszer- vagy egyéni teljesítményszámlálójával és kategóriapéldányával.

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)

Paraméterek

categoryName

String

Annak a teljesítményszámláló-kategóriának (teljesítményobjektumnak) a neve, amelyhez ez a teljesítményszámláló társítva van.

counterName

String

A teljesítményszámláló neve.

instanceName

String

A teljesítményszámláló kategóriapéldányának neve vagy egy üres sztring (""), ha a kategória egyetlen példányt tartalmaz.

readOnly

Boolean

true számláló írásvédett módban való elérése; false számláló olvasási/írási módban való eléréséhez.

Kivételek

InvalidOperationException

categoryName üres sztring ("").

-vagy-

counterName üres sztring ("").

-vagy-

A kért olvasási/írási engedélybeállítás érvénytelen ehhez a számlálóhoz.

-vagy-

A megadott kategória nem létezik (ha readOnly van true).

-vagy-

A megadott kategória nem egyéni .NET keretrendszer kategória (ha readOnlyfalse).

-vagy-

A megadott kategória többpéldányosként van megjelölve, és megköveteli, hogy a teljesítményszámlálót példánynévvel hozza létre.

-vagy-

instanceName 127 karakternél hosszabb.

-vagy-

categoryName és counterName különböző nyelvekre lettek honosítva.

ArgumentNullException

categoryName vagy counterName az null.

Win32Exception

Hiba történt egy rendszer API elérésekor.

UnauthorizedAccessException

A rendszergazdai jogosultságok nélkül végrehajtó kód megkísérelt beolvasni egy teljesítményszámlálót.

Megjegyzések

A paramétersztringek nem megkülönböztetik a kis- és nagybetűket.

Ezzel a túlterheléssel elérheti a teljesítményszámlálót írásvédett vagy írási/olvasási módban.

A konstruktor túlterhelése a CategoryNamemegadott értékekre állítja a , CounterNameés InstanceName a tulajdonságokat, és beállítja a MachineName tulajdonságot a helyi számítógépre, a "." értékre.

Ez a konstruktor inicializálja a teljesítményszámlálót, és társítja a példányt egy meglévő számlálóval (rendszer vagy egyéni számláló) a helyi számítógépen. A , CategoryNameés CounterName a tulajdonságok számára InstanceNameátadott értékeknek a helyi számítógépen meglévő teljesítményszámlálóra kell mutatniuk. Ha a teljesítményszámláló által jelzett példány érvénytelen, a konstruktor meghívása kivételt eredményez.

Note

Ezzel a túlterheléssel csatlakozhat egy rendszerszámlálóhoz, de nem írhat rendszerszámlálóba. Ezért a readOnlyfalse rendszerszámlálóhoz való csatlakozáskor a konstruktor kivételt okoz.

Teljesítménykategória-példány létrehozásához adjon meg egy instanceName konstruktort PerformanceCounter . Ha a megadott instanceName kategóriapéldány már létezik, az új objektum a meglévő kategóriapéldányra hivatkozik.

Note

A teljesítményszámlálók Windows Vista, Windows XP Professional x64 Edition vagy 2003-Windows Server olvasásához vagy a Performance Monitor Felhasználók csoport tagjának kell lennie, vagy rendszergazdai jogosultságokkal kell rendelkeznie.

Ha el szeretné kerülni, hogy emelje a jogosultságait a teljesítményszámlálókhoz való hozzáféréshez a Windows Vista, vegye fel magát a Performance Monitor Felhasználók csoportba.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A teljesítményszámlálókhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

PerformanceCounter(String, String, String, String)

Forrás:

PerformanceCounter.cs

Inicializálja az PerformanceCounter osztály új, írásvédett példányát, és társítja azt a megadott rendszer- vagy egyéni teljesítményszámlálóhoz és kategóriapéldányhoz a megadott számítógépen.

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)

Paraméterek

categoryName

String

Annak a teljesítményszámláló-kategóriának (teljesítményobjektumnak) a neve, amelyhez ez a teljesítményszámláló társítva van.

counterName

String

A teljesítményszámláló neve.

instanceName

String

A teljesítményszámláló kategóriapéldányának neve vagy egy üres sztring (""), ha a kategória egyetlen példányt tartalmaz.

machineName

String

Az a számítógép, amelyen a teljesítményszámláló és a hozzá tartozó kategória létezik.

Kivételek

InvalidOperationException

categoryName üres sztring ("").

-vagy-

counterName üres sztring ("").

-vagy-

A kért olvasási/írási engedélybeállítás érvénytelen ehhez a számlálóhoz.

-vagy-

A számláló nem létezik a megadott számítógépen.

-vagy-

A megadott kategória többpéldányosként van megjelölve, és megköveteli, hogy a teljesítményszámlálót példánynévvel hozza létre.

-vagy-

instanceName 127 karakternél hosszabb.

-vagy-

categoryName és counterName különböző nyelvekre lettek honosítva.

ArgumentException

A machineName paraméter érvénytelen.

ArgumentNullException

categoryName vagy counterName az null.

Win32Exception

Hiba történt egy rendszer API elérésekor.

UnauthorizedAccessException

A rendszergazdai jogosultságok nélkül végrehajtó kód megkísérelt beolvasni egy teljesítményszámlálót.

Megjegyzések

A paramétersztringek nem megkülönböztetik a kis- és nagybetűket.

A konstruktor túlterhelése beállítja a CategoryName, CounterName, InstanceNameés MachineName tulajdonságokat az átadott értékekre.

Ez a konstruktor inicializálja a teljesítményszámlálót, és társítja a példányt egy meglévő számlálóval (rendszer vagy egyéni számláló) a megadott számítógépen. A , CategoryNameCounterName és InstanceName a tulajdonságok számára MachineNameátadott értékeknek egy meglévő teljesítményszámlálóra kell mutatniuk. Ha a teljesítményszámláló által jelzett példány érvénytelen, a konstruktor meghívása kivételt eredményez. Ez a túlterhelés bármilyen írásvédett vagy írási/olvasási számlálóhoz hozzáfér, de ezt írásvédett módban teszi. Az PerformanceCounter ezzel a túlterheléssel létrehozott példány nem tud írni a számlálóba, még akkor sem, ha maga a számláló olvasható/írható.

Note

Nem írhat távoli teljesítményszámlálókba. Nincs túlterhelés, amely lehetővé teszi a távoli számítógéphez csatlakozó osztály olvasási/írási példányának PerformanceCounter megadását.

Teljesítménykategória-példány létrehozásához adjon meg egy instanceName konstruktort PerformanceCounter . Ha a megadott instanceName kategóriapéldány már létezik, az új objektum a meglévő kategóriapéldányra hivatkozik.

Note

A teljesítményszámlálók Windows Vista, Windows XP Professional x64 Edition vagy 2003-Windows Server olvasásához vagy a Performance Monitor Felhasználók csoport tagjának kell lennie, vagy rendszergazdai jogosultságokkal kell rendelkeznie.

Ha el szeretné kerülni, hogy emelje a jogosultságait a teljesítményszámlálókhoz való hozzáféréshez a Windows Vista, vegye fel magát a Performance Monitor Felhasználók csoportba.

Windows Vista rendszerben a felhasználói fiókok felügyelete (UAC) határozza meg a felhasználó jogosultságait. Ha Tagja a Beépített rendszergazdák csoportnak, két futásidejű hozzáférési jogkivonatot kap: egy standard felhasználói hozzáférési jogkivonatot és egy rendszergazdai hozzáférési jogkivonatot. Alapértelmezés szerint a szokásos felhasználói szerepkörben van. A teljesítményszámlálókhoz hozzáférő kód végrehajtásához először emelnie kell a jogosultságokat a standard felhasználóról a rendszergazdára. Ezt az alkalmazás indításakor megteheti úgy, hogy a jobb gombbal az alkalmazás ikonra kattint, és jelzi, hogy rendszergazdaként szeretne futni.

Note

A Windows Vista, amikor a távoli számítógép egy munkacsoport tagja, előfordulhat, hogy le kell tiltania az UAC-t, hogy a helyi felhasználói fiók ne legyen szűrve, és rendszergazdai fiókra emelhető. Biztonsági okokból a UAC letiltását végső megoldásnak kell lennie. A felhasználói fiókok felügyeletének és a WMI-nek a letiltásával kapcsolatos információkért lásd: Felhasználói fiókok felügyelete és WMI.