PerformanceCounter Konstruktory

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Pakiet:

System.Diagnostics.PerformanceCounter v8.0.0

Inicjuje nowe wystąpienie klasy PerformanceCounter.

Przeciążenia

PerformanceCounter()	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu bez skojarzenia wystąpienia z dowolnym systemem lub niestandardowym licznikiem wydajności.
PerformanceCounter(String, String)	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria miała pojedyncze wystąpienie.
PerformanceCounter(String, String, Boolean)	Inicjuje nowe wystąpienie klasy tylko do odczytu lub odczytu/zapisu PerformanceCounter i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria zawierała pojedyncze wystąpienie.
PerformanceCounter(String, String, String)	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.
PerformanceCounter(String, String, String, Boolean)	Inicjuje nowe, tylko do odczytu lub odczytu/zapisu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.
PerformanceCounter(String, String, String, String)	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na określonym komputerze.

PerformanceCounter()

Źródło:

PerformanceCounter.cs

Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu bez skojarzenia wystąpienia z dowolnym systemem lub niestandardowym licznikiem wydajności.

public:
 PerformanceCounter();

public PerformanceCounter ();

Public Sub New ()

Przykłady

Poniższy przykład kodu tworzy domyślne wystąpienie PerformanceCounter klasy. Po utworzeniu CategoryNamewystąpienia zostaną ustawione wartości właściwości , CounterNamei InstanceName , a wyniki wywołania NextValue metody zostaną wyświetlone.

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

Uwagi

To przeciążenie konstruktora ustawia CategoryNamewłaściwości , CounterNamei InstanceName na puste ciągi ("") i ustawia MachineName właściwość na komputer lokalny (".").

Ten konstruktor nie inicjuje licznika wydajności, więc nie kojarzy wystąpienia z istniejącym licznikiem na komputerze lokalnym. Aby wskazać określony licznik wydajności, ustaw CategoryNamewłaściwości , CounterNamei, opcjonalnie, InstanceNameMachineName przed odczytaniem innych właściwości lub próbując odczytać z licznika. Aby zapisać w liczniku ReadOnly wydajności, ustaw właściwość na false.

Uwaga

Atrybut HostProtectionAttribute zastosowany do tego elementu członkowskiego ma następującą Resources wartość właściwości: Synchronization | SharedState. Atrybut HostProtectionAttribute nie ma wpływu na aplikacje pulpitu (które typowo są uruchamiane przez dwukrotne kliknięcie ikony, wpisanie polecenia albo wprowadzenie adresu URL w przeglądarce). Aby uzyskać więcej informacji, zobacz klasę HostProtectionAttribute lub SQL Server Programowanie i atrybuty ochrony hosta.

PerformanceCounter(String, String)

Źródło:

PerformanceCounter.cs

Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria miała pojedyncze wystąpienie.

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)

Parametry

categoryName

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

counterName

String

Nazwa licznika wydajności.

Wyjątki

InvalidOperationException

categoryName jest pustym ciągiem ("").

-lub-

counterName jest pustym ciągiem ("").

-lub-

Określona kategoria nie istnieje.

-lub-

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności o nazwie wystąpienia.

-lub-

categoryName i counterName zostały zlokalizowane w różnych językach.

ArgumentNullException

categoryName lub counterName to null.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych próbował odczytać licznik wydajności.

Uwagi

Ciągi parametrów nie są uwzględniane wielkości liter.

Użyj tego przeciążenia, aby uzyskać dostęp do licznika na komputerze lokalnym należącym do kategorii zawierającej pojedyncze wystąpienie kategorii licznika wydajności. Jeśli próbujesz użyć tego konstruktora, aby wskazać to PerformanceCounter wystąpienie do kategorii zawierającej wiele wystąpień, konstruktor zgłasza wyjątek. To przeciążenie może uzyskać dostęp do dowolnego licznika tylko do odczytu lub odczytu/zapisu, ale robi to w trybie tylko do odczytu. Wystąpienie PerformanceCounter utworzone przy użyciu tego przeciążenia nie może zapisywać w liczniku, nawet jeśli sam licznik jest odczyt/zapis.

To przeciążenie konstruktora ustawia CategoryName właściwości i CounterName na przekazane wartości, ustawia MachineName właściwość na komputer lokalny "." i ustawia InstanceName właściwość na pusty ciąg ("").

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (systemem lub licznikiem niestandardowym) na komputerze lokalnym. Wartości przekazywane dla CategoryName właściwości i CounterName muszą wskazywać istniejący licznik wydajności na komputerze lokalnym.

Uwaga

Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista lub nowszym, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista, dodaj się do grupy użytkownicy monitor wydajności.

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, musisz najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

PerformanceCounter(String, String, Boolean)

Źródło:

PerformanceCounter.cs

Inicjuje nowe, tylko do odczytu lub odczytu/zapisu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności na komputerze lokalnym. Ten konstruktor wymaga, aby kategoria zawierała pojedyncze wystąpienie.

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)

Parametry

categoryName

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

counterName

String

Nazwa licznika wydajności.

readOnly

Boolean

true aby uzyskać dostęp do licznika w trybie tylko do odczytu (chociaż sam licznik może być odczytywany/zapisywany); false aby uzyskać dostęp do licznika w trybie odczytu/zapisu.

Wyjątki

InvalidOperationException

Jest categoryName to pusty ciąg ("").

-lub-

Jest counterName to pusty ciąg ("").

-lub-

Określona kategoria nie istnieje. (jeśli readOnly to true).

-lub-

Określona kategoria nie jest kategorią niestandardową .NET Framework (jeśli readOnly jest to false).

-lub-

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności o nazwie wystąpienia.

-lub-

categoryName i counterName zostały zlokalizowane w różnych językach.

ArgumentNullException

categoryName lub counterName to null.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych próbował odczytać licznik wydajności.

Przykłady

Poniższy przykład kodu tworzy wystąpienie PerformanceCounter klasy. Przykład przekazuje nazwy kategorii, nazwy liczników i wartość flagi wskazującą, że licznik nie jest tylko do odczytu. Ten przykład kodu jest częścią większego przykładu PerformanceCounter dla klasy.

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

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

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

Uwagi

Ciągi parametrów nie są uwzględniane wielkości liter.

Użyj tego przeciążenia, aby uzyskać dostęp do licznika tylko do odczytu lub odczytu/zapisu na komputerze lokalnym, który należy do kategorii zawierającej jedno wystąpienie kategorii licznika wydajności. Jeśli próbujesz użyć tego konstruktora, aby wskazać to PerformanceCounter wystąpienie do kategorii zawierającej wiele wystąpień, konstruktor zgłasza wyjątek.

To przeciążenie konstruktora ustawia CategoryNamewłaściwości , CounterNamei ReadOnly na wartości przekazywane, ustawia MachineName właściwość na komputer lokalny ". i ustawia InstanceName właściwość na pusty ciąg ("").

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (systemem lub licznikiem niestandardowym) na komputerze lokalnym. Wartości przekazywane dla CategoryName właściwości i CounterName muszą wskazywać istniejący licznik wydajności na komputerze lokalnym. Jeśli wystąpienie licznika wydajności, do którego wskazujesz, jest nieprawidłowe, wywołanie konstruktora zgłasza wyjątek.

Uwaga

Za pomocą tego przeciążenia można nawiązać połączenie z licznikiem systemu, ale nie można zapisać go w liczniku systemu. W związku z tym ustawienie na wartość podczas readOnlyfalse nawiązywania połączenia z licznikiem systemu powoduje, że konstruktor zgłasza wyjątek.

Uwaga

Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista lub nowszym, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista, dodaj się do grupy użytkownicy monitor wydajności.

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, musisz najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

PerformanceCounter(String, String, String)

Źródło:

PerformanceCounter.cs

Inicjuje nowe, tylko do odczytu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.

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)

Parametry

categoryName

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

counterName

String

Nazwa licznika wydajności.

instanceName

String

Nazwa wystąpienia kategorii licznika wydajności lub pusty ciąg (""), jeśli kategoria zawiera jedno wystąpienie.

Wyjątki

InvalidOperationException

categoryName jest pustym ciągiem ("").

-lub-

counterName jest pustym ciągiem ("").

-lub-

Określona kategoria jest nieprawidłowa.

-lub-

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności z nazwą wystąpienia.

-lub-

instanceName jest dłuższa niż 127 znaków.

-lub-

categoryName i counterName zostały zlokalizowane w różnych językach.

ArgumentNullException

categoryName lub counterName ma wartość null.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych, który próbował odczytać licznik wydajności.

Uwagi

W ciągach parametrów nie jest uwzględniana wielkość liter.

To przeciążenie konstruktora ustawia CategoryNamewłaściwości , CounterNamei InstanceName na przekazane wartości i ustawia MachineName właściwość na komputer lokalny ".

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (systemem lub licznikiem niestandardowym) na komputerze lokalnym. Wartości przekazywane dla CategoryNamewłaściwości , CounterNamei InstanceName muszą wskazywać istniejący licznik wydajności na komputerze lokalnym. Jeśli wystąpienie licznika wydajności, do którego wskazujesz, jest nieprawidłowe, wywołanie konstruktora zgłasza wyjątek.

To przeciążenie może uzyskać dostęp do dowolnego licznika tylko do odczytu lub odczytu/zapisu, ale robi to w trybie tylko do odczytu. Wystąpienie PerformanceCounter utworzone przy użyciu tego przeciążenia nie może zapisywać w liczniku, nawet jeśli sam licznik jest odczyt/zapis.

Aby utworzyć wystąpienie kategorii wydajności, określ element instanceName w konstruktorze PerformanceCounter . Jeśli wystąpienie kategorii określone przez instanceName już istnieje, nowy obiekt będzie odwoływać się do istniejącego wystąpienia kategorii.

Uwaga

Aby odczytać liczniki wydajności w systemie Windows Vista, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista, dodaj siebie do grupy użytkownicy monitor wydajności.

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, należy najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

PerformanceCounter(String, String, String, Boolean)

Źródło:

PerformanceCounter.cs

Inicjuje nowe, tylko do odczytu lub odczytu/zapisu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na komputerze lokalnym.

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)

Parametry

categoryName

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

counterName

String

Nazwa licznika wydajności.

instanceName

String

Nazwa wystąpienia kategorii licznika wydajności lub pusty ciąg (""), jeśli kategoria zawiera jedno wystąpienie.

readOnly

Boolean

true dostęp do licznika w trybie tylko do odczytu; false aby uzyskać dostęp do licznika w trybie odczytu/zapisu.

Wyjątki

InvalidOperationException

categoryName jest pustym ciągiem ("").

-lub-

counterName jest pustym ciągiem ("").

-lub-

Żądane ustawienie uprawnień do odczytu/zapisu jest nieprawidłowe dla tego licznika.

-lub-

Określona kategoria nie istnieje (jeśli readOnly to true).

-lub-

Określona kategoria nie jest kategorią niestandardową .NET Framework (jeśli readOnly jest to false).

-lub-

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności z nazwą wystąpienia.

-lub-

instanceName jest dłuższa niż 127 znaków.

-lub-

categoryName i counterName zostały zlokalizowane w różnych językach.

ArgumentNullException

categoryName lub counterName ma wartość null.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych, który próbował odczytać licznik wydajności.

Uwagi

W ciągach parametrów nie jest uwzględniana wielkość liter.

Użyj tego przeciążenia, aby uzyskać dostęp do licznika wydajności w trybie tylko do odczytu lub odczytu/zapisu.

To przeciążenie konstruktora ustawia CategoryNamewłaściwości , CounterNamei InstanceName na przekazane wartości i ustawia MachineName właściwość na komputer lokalny ".

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (systemem lub licznikiem niestandardowym) na komputerze lokalnym. Wartości przekazywane dla CategoryNamewłaściwości , CounterNamei InstanceName muszą wskazywać istniejący licznik wydajności na komputerze lokalnym. Jeśli wystąpienie licznika wydajności, do którego wskazujesz, jest nieprawidłowe, wywołanie konstruktora zgłasza wyjątek.

Uwaga

Tego przeciążenia można użyć do nawiązania połączenia z licznikiem systemu, ale nie można zapisać w liczniku systemu. W związku z tym ustawienie na wartość podczas readOnlyfalse nawiązywania połączenia z licznikiem systemu powoduje, że konstruktor zgłasza wyjątek.

Aby utworzyć wystąpienie kategorii wydajności, określ element instanceName w konstruktorze PerformanceCounter . Jeśli wystąpienie kategorii określone przez instanceName już istnieje, nowy obiekt będzie odwoływać się do istniejącego wystąpienia kategorii.

Uwaga

Aby odczytać liczniki wydajności w systemie Windows Vista, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista, dodaj siebie do grupy użytkownicy monitor wydajności.

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, należy najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

PerformanceCounter(String, String, String, String)

Źródło:

PerformanceCounter.cs

Inicjuje nowe, tylko do odczytu wystąpienie PerformanceCounter klasy i kojarzy je z określonym systemem lub niestandardowym licznikiem wydajności i wystąpieniem kategorii na określonym komputerze.

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)

Parametry

categoryName

String

Nazwa kategorii licznika wydajności (obiektu wydajności), z którą jest skojarzony ten licznik wydajności.

counterName

String

Nazwa licznika wydajności.

instanceName

String

Nazwa wystąpienia kategorii licznika wydajności lub pusty ciąg (""), jeśli kategoria zawiera jedno wystąpienie.

machineName

String

Komputer, na którym istnieje licznik wydajności i skojarzona z nią kategoria.

Wyjątki

InvalidOperationException

categoryName jest pustym ciągiem ("").

-lub-

counterName jest pustym ciągiem ("").

-lub-

Żądane ustawienie uprawnień do odczytu/zapisu jest nieprawidłowe dla tego licznika.

-lub-

Licznik nie istnieje na określonym komputerze.

-lub-

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności z nazwą wystąpienia.

-lub-

instanceName jest dłuższa niż 127 znaków.

-lub-

categoryName i counterName zostały zlokalizowane w różnych językach.

ArgumentException

Parametr machineName jest nieprawidłowy.

ArgumentNullException

categoryName lub counterName ma wartość null.

Win32Exception

Wystąpił błąd podczas uzyskiwania dostępu do interfejsu API systemu.

UnauthorizedAccessException

Kod wykonywany bez uprawnień administracyjnych, który próbował odczytać licznik wydajności.

Uwagi

W ciągach parametrów nie jest uwzględniana wielkość liter.

To przeciążenie konstruktora ustawia CategoryNamewłaściwości , , InstanceNameCounterNamei MachineName na przekazane wartości.

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (systemem lub licznikiem niestandardowym) na określonym komputerze. Wartości przekazywane dla CategoryNamewłaściwości , CounterNameInstanceName i MachineName muszą wskazywać istniejący licznik wydajności. Jeśli wystąpienie licznika wydajności, do którego wskazujesz, jest nieprawidłowe, wywołanie konstruktora zgłasza wyjątek. To przeciążenie może uzyskać dostęp do dowolnego licznika tylko do odczytu lub odczytu/zapisu, ale robi to w trybie tylko do odczytu. Wystąpienie PerformanceCounter utworzone przy użyciu tego przeciążenia nie może zapisywać w liczniku, nawet jeśli sam licznik jest odczyt/zapis.

Uwaga

Nie można zapisywać w zdalnych licznikach wydajności. Nie ma przeciążenia, które umożliwia określenie wystąpienia PerformanceCounter odczytu/zapisu klasy, która łączy się z komputerem zdalnym.

Aby utworzyć wystąpienie kategorii wydajności, określ element instanceName w konstruktorze PerformanceCounter . Jeśli wystąpienie kategorii określone przez instanceName już istnieje, nowy obiekt będzie odwoływać się do istniejącego wystąpienia kategorii.

Uwaga

Aby odczytać liczniki wydajności w systemie Windows Vista, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy użytkownicy monitor wydajności lub mieć uprawnienia administracyjne.

Aby uniknąć konieczności podniesienia uprawnień dostępu do liczników wydajności w systemie Windows Vista, dodaj siebie do grupy użytkownicy monitor wydajności.

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do liczników wydajności, należy najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

Uwaga

W systemie Windows Vista, gdy komputer zdalny jest członkiem grupy roboczej, może być konieczne wyłączenie kontroli dostępu użytkownika, aby konto użytkownika lokalnego nie było filtrowane i można je podnieść do konta administratora. Ze względów bezpieczeństwa wyłączenie kontroli konta użytkownika powinno być w ostateczności. Aby uzyskać informacje na temat wyłączania kontroli konta użytkownika, zobacz Kontrola konta użytkownika i Usługa WMI.