PerformanceCounter Konstruktor

Referensi

Definisi

Ruang nama:: System.Diagnostics

Rakitan:: System.Diagnostics.PerformanceCounter.dll

Rakitan:: System.dll

Paket:: System.Diagnostics.PerformanceCounter v6.0.0

Paket:: System.Diagnostics.PerformanceCounter v7.0.0

Paket:: System.Diagnostics.PerformanceCounter v8.0.0

Paket:: System.Diagnostics.PerformanceCounter v9.0.0-preview.2.24128.5

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menginisialisasi instans baru kelas PerformanceCounter.

Overload

PerformanceCounter()	Menginisialisasi instans PerformanceCounter kelas baca-saja baru, tanpa mengaitkan instans dengan sistem atau penghitung kinerja kustom apa pun.
PerformanceCounter(String, String)	Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom di komputer lokal. Konstruktor ini mengharuskan kategori memiliki satu instans.
PerformanceCounter(String, String, Boolean)	Menginisialisasi instans PerformanceCounter kelas baru, baca-saja, atau baca/tulis dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom di komputer lokal. Konstruktor ini mengharuskan kategori berisi satu instans.
PerformanceCounter(String, String, String)	Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori di komputer lokal.
PerformanceCounter(String, String, String, Boolean)	Menginisialisasi instans PerformanceCounter kelas baru, baca-saja atau baca/tulis dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori di komputer lokal.
PerformanceCounter(String, String, String, String)	Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori, pada komputer yang ditentukan.

PerformanceCounter()

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans PerformanceCounter kelas baca-saja baru, tanpa mengaitkan instans dengan sistem atau penghitung kinerja kustom apa pun.

public:
 PerformanceCounter();

public PerformanceCounter ();

Public Sub New ()

Contoh

Contoh kode berikut membuat instans PerformanceCounter default kelas. Setelah instans dibuat, CategoryNamenilai properti , CounterName, dan InstanceName diatur, dan hasil panggilan ke NextValue metode ditampilkan.

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

Keterangan

Kelebihan beban konstruktor ini mengatur CategoryNameproperti , CounterName, dan InstanceName ke string kosong (""), dan mengatur MachineName properti ke komputer lokal, (".").

Konstruktor ini tidak menginisialisasi penghitung kinerja, sehingga tidak mengaitkan instans dengan penghitung yang ada di komputer lokal. Untuk menunjuk ke penghitung kinerja tertentu, atur CategoryName CounterName, , dan, secara opsional, InstanceName properti dan MachineName sebelum membaca properti lain atau mencoba membaca dari penghitung. Untuk menulis ke penghitung kinerja, atur properti ke ReadOnlyfalse.

Catatan

Atribut HostProtectionAttribute yang diterapkan ke anggota ini memiliki nilai properti berikutResources: | Synchronization SharedState . HostProtectionAttribute tidak memengaruhi aplikasi desktop (yang biasanya dimulai dengan mengklik dua kali ikon, mengetik perintah, atau memasukkan URL di browser). Untuk informasi selengkapnya, lihat HostProtectionAttribute kelas atau SQL Server Atribut Pemrograman dan Perlindungan Host.

Berlaku untuk

PerformanceCounter(String, String)

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom di komputer lokal. Konstruktor ini mengharuskan kategori memiliki satu instans.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);

public PerformanceCounter (string categoryName, string counterName);

new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String)

Parameter

categoryName: String

Nama kategori penghitung kinerja (objek performa) yang terkait dengan penghitung kinerja ini.

counterName: String

Nama penghitung kinerja.

Pengecualian

InvalidOperationException

categoryName adalah string kosong ("").

-atau-

counterName adalah string kosong ("").

-atau-

Kategori yang ditentukan tidak ada.

-atau-

Kategori yang ditentukan ditandai sebagai multi-instans dan mengharuskan penghitung kinerja dibuat dengan nama instans.

-atau-

categoryName dan counterName telah dilokalkan ke dalam bahasa yang berbeda.

ArgumentNullException

categoryName atau counterName adalah null.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak administratif mencoba membaca penghitung kinerja.

Keterangan

String parameter tidak peka huruf besar/kecil.

Gunakan kelebihan beban ini untuk mengakses penghitung di komputer lokal yang termasuk dalam kategori yang berisi satu instans kategori penghitung kinerja. Jika Anda mencoba menggunakan konstruktor ini untuk mengarahkan instans ini PerformanceCounter ke kategori yang berisi beberapa instans, konstruktor akan melemparkan pengecualian. Kelebihan beban ini dapat mengakses penghitung baca-saja atau baca/tulis, tetapi melakukannya dalam mode baca-saja. Instans yang PerformanceCounter dibuat menggunakan kelebihan beban ini tidak dapat menulis ke penghitung, bahkan jika penghitung itu sendiri adalah baca/tulis.

Kelebihan beban konstruktor ini mengatur CategoryName properti dan CounterName ke nilai yang Anda berikan, mengatur MachineName properti ke komputer lokal, ".", dan mengatur InstanceName properti ke string kosong ("").

Catatan

Untuk membaca penghitung kinerja dari sesi masuk non-interaktif di Windows Vista dan yang lebih baru, Windows XP Professional x64 Edition, atau Windows Server 2003, Anda harus menjadi anggota grup Pengguna Monitor Performa atau memiliki hak administratif.

Untuk menghindari harus meningkatkan hak istimewa Anda untuk mengakses penghitung kinerja di Windows Vista, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Di Windows Vista, Kontrol Akun Pengguna (UAC) menentukan hak istimewa pengguna. Jika Anda adalah anggota grup Administrator Bawaan, Anda diberi dua token akses run-time: token akses pengguna standar dan token akses administrator. Secara default, Anda berada dalam peran pengguna standar. Untuk menjalankan kode yang mengakses penghitung kinerja, Anda harus terlebih dahulu meningkatkan hak istimewa Anda dari pengguna standar ke administrator. Anda dapat melakukan ini saat memulai aplikasi dengan mengeklik kanan ikon aplikasi dan menunjukkan bahwa Anda ingin menjalankan sebagai administrator.

Berlaku untuk

PerformanceCounter(String, String, Boolean)

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans baru baca-saja atau baca/tulis kelas PerformanceCounter dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom di komputer lokal. Konstruktor ini mengharuskan kategori berisi satu instans.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

Parameter

categoryName: String

Nama kategori penghitung kinerja (objek performa) yang terkait dengan penghitung kinerja ini.

counterName: String

Nama penghitung kinerja.

readOnly: Boolean

true untuk mengakses penghitung dalam mode baca-saja (meskipun penghitung itu sendiri bisa baca/tulis); false untuk mengakses penghitung dalam mode baca/tulis.

Pengecualian

InvalidOperationException

categoryName adalah string kosong ("").

-atau-

counterName adalah string kosong ("").

-atau-

Kategori yang ditentukan tidak ada. (jika readOnly adalah true).

-atau-

Kategori yang ditentukan bukan kategori kustom .NET Framework (jika readOnly adalah false).

-atau-

Kategori yang ditentukan ditandai sebagai multi-instans dan mengharuskan penghitung kinerja dibuat dengan nama instans.

-atau-

categoryName dan counterName telah dilokalkan ke dalam bahasa yang berbeda.

ArgumentNullException

categoryName atau counterName adalah null.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak administratif mencoba membaca penghitung kinerja.

Contoh

Contoh kode berikut membuat instans PerformanceCounter kelas . Contoh lolos dalam nama kategori, nama penghitung, dan nilai bendera yang menunjukkan bahwa penghitung tidak baca-saja. Contoh kode ini adalah bagian dari contoh yang lebih besar untuk PerformanceCounter kelas .

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

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

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

Keterangan

String parameter tidak peka huruf besar/kecil.

Gunakan kelebihan beban ini untuk mengakses penghitung baca-saja atau baca/tulis di komputer lokal yang termasuk dalam kategori yang berisi instans kategori penghitung kinerja tunggal. Jika Anda mencoba menggunakan konstruktor ini untuk mengarahkan instans ini PerformanceCounter ke kategori yang berisi beberapa instans, konstruktor akan melemparkan pengecualian.

Kelebihan beban konstruktor ini mengatur CategoryNameproperti , CounterName, dan ReadOnly ke nilai yang Anda berikan, mengatur MachineName properti ke komputer lokal, ".", dan mengatur InstanceName properti ke string kosong ("").

Konstruktor ini menginisialisasi penghitung kinerja dan mengaitkan instans dengan penghitung yang ada (baik sistem atau penghitung kustom) di komputer lokal. Nilai yang Anda berikan untuk CategoryName properti dan CounterName harus menunjuk ke penghitung kinerja yang ada di komputer lokal. Jika instans penghitung kinerja yang Anda tunjuk tidak valid, memanggil konstruktor akan memberikan pengecualian.

Catatan

Anda dapat menggunakan kelebihan beban ini untuk terhubung ke penghitung sistem, tetapi Anda tidak dapat menulis ke penghitung sistem. Oleh karena itu, mengatur readOnly ke false saat menyambungkan ke penghitung sistem menyebabkan konstruktor melemparkan pengecualian.

Catatan

Untuk menghindari harus meningkatkan hak istimewa Anda untuk mengakses penghitung kinerja di Windows Vista, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Berlaku untuk

PerformanceCounter(String, String, String)

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori di komputer lokal.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);

public PerformanceCounter (string categoryName, string counterName, string instanceName);

new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String)

Parameter

categoryName: String

Nama kategori penghitung kinerja (objek performa) yang dikaitkan dengan penghitung kinerja ini.

counterName: String

Nama penghitung kinerja.

instanceName: String

Nama instans kategori penghitung kinerja, atau string kosong (""), jika kategori berisi satu instans.

Pengecualian

InvalidOperationException

categoryName adalah string kosong ("").

-atau-

counterName adalah string kosong ("").

-atau-

Kategori yang ditentukan tidak valid.

-atau-

Kategori yang ditentukan ditandai sebagai multi-instans dan mengharuskan penghitung kinerja dibuat dengan nama instans.

-atau-

instanceName lebih panjang dari 127 karakter.

-atau-

categoryName dan counterName telah dilokalkan ke dalam berbagai bahasa.

ArgumentNullException

categoryName atau counterName adalah null.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak istimewa administratif mencoba membaca penghitung kinerja.

Keterangan

String parameter tidak peka huruf besar/kecil.

Kelebihan beban konstruktor ini mengatur CategoryNameproperti , CounterName, dan InstanceName ke nilai yang Anda berikan, dan mengatur MachineName properti ke komputer lokal, ".".

Konstruktor ini menginisialisasi penghitung kinerja dan mengaitkan instans dengan penghitung yang ada (baik sistem atau penghitung kustom) di komputer lokal. Nilai yang Anda berikan untuk CategoryNameproperti , , CounterNamedan InstanceName harus menunjuk ke penghitung kinerja yang ada di komputer lokal. Jika instans penghitung kinerja yang Anda tunjuk tidak valid, memanggil konstruktor akan memberikan pengecualian.

Kelebihan beban ini dapat mengakses penghitung baca-saja atau baca/tulis, tetapi melakukannya dalam mode baca-saja. Instans yang PerformanceCounter dibuat menggunakan kelebihan beban ini tidak dapat menulis ke penghitung, bahkan jika penghitung itu sendiri adalah baca/tulis.

Untuk membuat instans kategori performa, tentukan instanceName pada PerformanceCounter konstruktor. Jika instans kategori yang ditentukan oleh instanceName sudah ada, objek baru akan mereferensikan instans kategori yang ada.

Catatan

Untuk membaca penghitung kinerja di Windows Vista, Windows XP Professional x64 Edition, atau Windows Server 2003, Anda harus menjadi anggota grup Pengguna Monitor Performa atau memiliki hak administratif.

Untuk menghindari keharusan meningkatkan hak istimewa Anda untuk mengakses penghitung kinerja di Windows Vista, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Berlaku untuk

PerformanceCounter(String, String, String, Boolean)

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans baru, baca-saja atau baca/tulis kelas PerformanceCounter dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori di komputer lokal.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);

public PerformanceCounter (string categoryName, string counterName, string instanceName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

Parameter

categoryName: String

Nama kategori penghitung kinerja (objek performa) yang dikaitkan dengan penghitung kinerja ini.

counterName: String

Nama penghitung kinerja.

instanceName: String

Nama instans kategori penghitung kinerja, atau string kosong (""), jika kategori berisi satu instans.

readOnly: Boolean

true untuk mengakses penghitung dalam mode baca-saja; false untuk mengakses penghitung dalam mode baca/tulis.

Pengecualian

InvalidOperationException

categoryName adalah string kosong ("").

-atau-

counterName adalah string kosong ("").

-atau-

Pengaturan izin baca/tulis yang diminta tidak valid untuk penghitung ini.

-atau-

Kategori yang ditentukan tidak ada (jika readOnly adalah true).

-atau-

Kategori yang ditentukan bukan kategori kustom .NET Framework (jika readOnly adalah false).

-atau-

Kategori yang ditentukan ditandai sebagai multi-instans dan mengharuskan penghitung kinerja dibuat dengan nama instans.

-atau-

instanceName lebih panjang dari 127 karakter.

-atau-

categoryName dan counterName telah dilokalkan ke dalam berbagai bahasa.

ArgumentNullException

categoryName atau counterName adalah null.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak istimewa administratif mencoba membaca penghitung kinerja.

Keterangan

String parameter tidak peka huruf besar/kecil.

Gunakan kelebihan beban ini untuk mengakses penghitung kinerja baik dalam mode baca-saja atau baca/tulis.

Kelebihan beban konstruktor ini mengatur CategoryNameproperti , CounterName, dan InstanceName ke nilai yang Anda berikan, dan mengatur MachineName properti ke komputer lokal, ".".

Konstruktor ini menginisialisasi penghitung kinerja dan mengaitkan instans dengan penghitung yang ada (baik sistem atau penghitung kustom) di komputer lokal. Nilai yang Anda berikan untuk CategoryNameproperti , , CounterNamedan InstanceName harus menunjuk ke penghitung kinerja yang ada di komputer lokal. Jika instans penghitung kinerja yang Anda tunjuk tidak valid, memanggil konstruktor akan memberikan pengecualian.

Catatan

Untuk menghindari keharusan meningkatkan hak istimewa Anda untuk mengakses penghitung kinerja di Windows Vista, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Berlaku untuk

PerformanceCounter(String, String, String, String)

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Sumber:: PerformanceCounter.cs

Menginisialisasi instans PerformanceCounter kelas baca-saja baru dan mengaitkannya dengan sistem yang ditentukan atau penghitung kinerja kustom dan instans kategori, pada komputer yang ditentukan.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);

public PerformanceCounter (string categoryName, string counterName, string instanceName, string machineName);

new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

Parameter

categoryName: String

Nama kategori penghitung kinerja (objek performa) yang dikaitkan dengan penghitung kinerja ini.

counterName: String

Nama penghitung kinerja.

instanceName: String

Nama instans kategori penghitung kinerja, atau string kosong (""), jika kategori berisi satu instans.

machineName: String

Komputer tempat penghitung kinerja dan kategori terkait ada.

Pengecualian

InvalidOperationException

categoryName adalah string kosong ("").

-atau-

counterName adalah string kosong ("").

-atau-

Pengaturan izin baca/tulis yang diminta tidak valid untuk penghitung ini.

-atau-

Penghitung tidak ada pada komputer yang ditentukan.

-atau-

Kategori yang ditentukan ditandai sebagai multi-instans dan mengharuskan penghitung kinerja dibuat dengan nama instans.

-atau-

instanceName lebih panjang dari 127 karakter.

-atau-

categoryName dan counterName telah dilokalkan ke dalam berbagai bahasa.

ArgumentException

Parameter machineName tidak valid.

ArgumentNullException

categoryName atau counterName adalah null.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak istimewa administratif mencoba membaca penghitung kinerja.

Keterangan

String parameter tidak peka huruf besar/kecil.

Kelebihan beban konstruktor ini mengatur CategoryNameproperti , , CounterName InstanceName, dan MachineName ke nilai yang Anda berikan.

Konstruktor ini menginisialisasi penghitung kinerja dan mengaitkan instans dengan penghitung yang ada (baik sistem atau penghitung kustom) pada komputer yang ditentukan. Nilai yang Anda berikan untuk CategoryNameproperti , , CounterName InstanceName dan MachineName harus menunjuk ke penghitung kinerja yang ada. Jika instans penghitung kinerja yang Anda tunjuk tidak valid, memanggil konstruktor akan memberikan pengecualian. Kelebihan beban ini dapat mengakses penghitung baca-saja atau baca/tulis, tetapi melakukannya dalam mode baca-saja. Instans yang PerformanceCounter dibuat menggunakan kelebihan beban ini tidak dapat menulis ke penghitung, bahkan jika penghitung itu sendiri adalah baca/tulis.

Catatan

Anda tidak dapat menulis ke penghitung kinerja jarak jauh. Tidak ada kelebihan beban yang memungkinkan Anda menentukan instans baca/tulis kelas PerformanceCounter yang tersambung ke komputer jarak jauh.

Catatan

Untuk menghindari harus meningkatkan hak istimewa Anda untuk mengakses penghitung kinerja di Windows Vista, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Catatan

Di Windows Vista, ketika komputer jarak jauh adalah anggota grup kerja, Anda mungkin perlu menonaktifkan UAC sehingga akun pengguna lokal tidak difilter dan dapat ditingkatkan ke akun administrator. Untuk alasan keamanan, menonaktifkan UAC harus menjadi upaya terakhir. Untuk informasi tentang menonaktifkan UAC, lihat Kontrol Akun Pengguna dan WMI.

Berlaku untuk

Bagikan melalui

PerformanceCounter Konstruktor

Definisi

Overload

PerformanceCounter()

Contoh

Keterangan

Berlaku untuk

PerformanceCounter(String, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

PerformanceCounter(String, String, Boolean)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

PerformanceCounter(String, String, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

PerformanceCounter(String, String, String, Boolean)

Parameter

Pengecualian

Keterangan

Berlaku untuk

PerformanceCounter(String, String, String, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: