PerformanceCounter Konstruktory

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Inicjuje nowe wystąpienie klasy PerformanceCounter.

Przeciążenia

Nazwa	Opis
PerformanceCounter()	Inicjuje nowe wystąpienie PerformanceCounter klasy tylko do odczytu bez kojarzenia wystąpienia z dowolnym systemem lub niestandardowym licznikiem wydajności.
PerformanceCounter(String, String)	Inicjuje nowe, tylko do odczytu wystąpienie PerformanceCounter klasy 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, tylko do odczytu lub 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.
PerformanceCounter(String, String, String)	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.
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 kojarzenia 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 są ustawiane wartości właściwości , CounterNamei InstanceName , a wyniki wywołania NextValue metody są wyświetlane.

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, dlatego 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óbuje odczytać z licznika. Aby zapisać w liczniku ReadOnly wydajności, ustaw właściwość na falsewartość .

Uwaga / Notatka

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

PerformanceCounter(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 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 przy użyciu nazwy wystąpienia.

— 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 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 spró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 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 (system lub licznik niestandardowy) 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 / Notatka

Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista i nowszych, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy Użytkownicy monitora 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 monitora 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: standardowy token dostępu użytkownika 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 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 ma wartość true).

— lub —

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

— lub —

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności przy użyciu nazwy wystąpienia.

— 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 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 .

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 należącym do kategorii zawierającej pojedyncze wystąpienie kategorii licznika wydajności. Jeśli spró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, które przekazujesz, 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 (system lub licznik niestandardowy) 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 / Notatka

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.

Uwaga / Notatka

Aby odczytać liczniki wydajności z sesji logowania nieinterakcyjnego w systemie Windows Vista i nowszych, Windows XP Professional x64 Edition lub Windows Server 2003, musisz być członkiem grupy Użytkownicy monitora 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 monitora 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: standardowy token dostępu użytkownika 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 pojedyncze 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 przy użyciu nazwy 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 próbował odczytać licznik wydajności.

Uwagi

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

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

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (system lub licznik niestandardowy) 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 / Notatka

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 monitora 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 monitora 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: standardowy token dostępu użytkownika 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, 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 pojedyncze wystąpienie.

readOnly

Boolean

true aby uzyskać 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ń odczytu/zapisu jest nieprawidłowe dla tego licznika.

— lub —

Określona kategoria nie istnieje (jeśli readOnly ma wartość true).

— lub —

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

— lub —

Określona kategoria jest oznaczona jako wiele wystąpień i wymaga utworzenia licznika wydajności przy użyciu nazwy 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 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 wydajności w trybie tylko do odczytu lub odczytu/zapisu.

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

Ten konstruktor inicjuje licznik wydajności i kojarzy wystąpienie z istniejącym licznikiem (system lub licznik niestandardowy) 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 / Notatka

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 / Notatka

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 monitora 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 monitora 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: standardowy token dostępu użytkownika 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, 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 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 pojedyncze 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ń 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 przy użyciu nazwy 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 próbował odczytać licznik wydajności.

Uwagi

Ciągi parametrów nie są uwzględniane wielkości 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 (system lub licznik niestandardowy) 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 / Notatka

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 łączącej 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 / Notatka

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 monitora 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 monitora 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: standardowy token dostępu użytkownika 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.

Uwaga / Notatka

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 dostępu użytkownika powinno być ostatecznością. Aby uzyskać informacje na temat wyłączania kontroli konta użytkownika, zobacz Kontrola konta użytkownika i WMI.