PerformanceCounter.InstanceName Properti

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Sumber:

PerformanceCounter.cs

Mendapatkan atau menetapkan nama instans untuk penghitung kinerja ini.

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Nilai Properti

String

Nama instans kategori penghitung kinerja, atau string kosong (""), jika penghitung adalah penghitung instans tunggal.

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

Catatan

Panjang nama instans harus lebih pendek dari 128 karakter.

Dalam beberapa situasi, kategori dibagi menjadi instans, yang melacak data tentang beberapa kemunculan objek yang terkait dengan kategori. Instans berlaku untuk kategori secara keseluruhan, bukan untuk penghitung individual. Setiap penghitung dalam kategori memiliki setiap instans yang ditentukan untuk kategori. Misalnya, kategori Proses berisi instans bernama Idle dan System. Setiap penghitung dalam kategori Proses dengan demikian berisi data untuk setiap instans, menunjukkan informasi tentang proses diam atau proses sistem.

Banyak kategori tidak berisi beberapa instans, sehingga Anda dapat membiarkan properti ini kosong untuk menunjukkan bahwa tidak ada instans yang terkait dengan kategori.

Jika instans ini PerformanceCounter menunjuk ke kategori nonkustom, Anda hanya dapat memilih dari instans kategori yang ada. Anda hanya dapat membuat instans kategori baru dalam kategori kustom, yang memungkinkan Anda menentukan penghitung dan instans kategori sebanyak yang Anda butuhkan.

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

Jangan gunakan karakter "(", ")", "#", "\", atau "/" dalam nama instans. Jika salah satu karakter ini digunakan, Performance Console (lihat Pembuatan Profil Runtime) mungkin tidak menampilkan nilai instans dengan benar.

Jika nama instans dibuat secara otomatis dan mungkin berisi karakter "(", ")", "#", "\", atau "/", gunakan pemetaan karakter dalam tabel berikut.

Karakter	Karakter yang dipetakan
(	[
)	]
#	_
\	_
/	_

Properti FriendlyName objek yang AppDomain diperoleh dari AppDomain.CurrentDomain properti adalah sumber umum nama instans yang dapat berisi karakter yang tidak valid.