PerformanceCounterCategory.ReadCategory Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Sumber:

PerformanceCounterCategory.cs

Membaca semua data penghitung dan instans objek performa yang terkait dengan kategori penghitung kinerja ini.

public:
 System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();

public System.Diagnostics.InstanceDataCollectionCollection ReadCategory ();

member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollection

Public Function ReadCategory () As InstanceDataCollectionCollection

Mengembalikan

InstanceDataCollectionCollection

InstanceDataCollectionCollection Yang berisi penghitung dan data instans objek performa untuk kategori.

Pengecualian

InvalidOperationException

Properti CategoryName adalah null. Properti mungkin belum disetel.

Win32Exception

Panggilan ke API sistem yang mendasar gagal.

UnauthorizedAccessException

Kode yang dijalankan tanpa hak administratif mencoba membaca penghitung kinerja.

Contoh

Contoh kode berikut membuat PerformanceCounterCategory untuk nama tertentu PerformanceCounterCategory . Kemudian menggunakan ReadCategory untuk mengembalikan InstanceDataCollectionCollection yang berisi data instans untuk semua instans PerformanceCounter objek dalam PerformanceCounterCategory.

// Process the InstanceDataCollectionCollection for this category.
PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
InstanceDataCollectionCollection idColCol = pcc.ReadCategory();
InstanceDataCollection[] idColArray = new InstanceDataCollection[idColCol.Count];

Console.WriteLine("InstanceDataCollectionCollection for \"{0}\" " +
    "has {1} elements.", categoryName, idColCol.Count);

' Process the InstanceDataCollectionCollection for this category.
Dim pcc As New PerformanceCounterCategory(categoryName)
Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()
Dim idColArray(idColCol.Count - 1) As InstanceDataCollection

Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
    "has {1} elements.", categoryName, idColCol.Count)

Keterangan

Anda harus mengatur CategoryName properti sebelum memanggil ReadCategory.

Membaca seluruh kategori sekaligus bisa seefisien membaca satu penghitung karena cara sistem menyediakan data.

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 dan yang lebih baru, tambahkan diri Anda ke grup Pengguna Monitor Performa.

Di Windows Vista dan yang lebih baru, Kontrol Akun Pengguna (User Account Control atau 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.

Lihat juga

• InstanceDataCollectionCollection
• InstanceDataCollection
• InstanceData