PerformanceCounter.RemoveInstance Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Sumber:

PerformanceCounter.cs

Menghapus instans kategori yang ditentukan oleh PerformanceCounter properti objek InstanceName .

public:
 void RemoveInstance();

public void RemoveInstance ();

member this.RemoveInstance : unit -> unit

Public Sub RemoveInstance ()

Pengecualian

InvalidOperationException

Penghitung ini bersifat baca-saja, sehingga instans apa pun yang terkait dengan kategori tidak dapat dihapus.

-atau-

Instans tidak dikaitkan dengan penghitung kinerja dengan benar.

-atau-

Properti InstanceLifetime diatur ke Process saat menggunakan memori bersama global.

Win32Exception

Terjadi kesalahan saat mengakses API sistem.

Keterangan

Anda hanya dapat menghapus instans untuk penghitung kustom. Semua penghitung sistem bersifat baca-saja, jadi mencoba untuk menghapus salah satunya melemparkan pengecualian.

Catatan

Untuk menghindari kemungkinan kondisi balapan ketika memori bersama penghitung kinerja dirilis, disarankan agar metode dipanggil RemoveInstance dari penanganan DomainUnload aktivitas.

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

Jika nilai untuk InstanceLifetime properti adalah Process dan kategori penghitung kinerja dibuat dengan .NET Framework versi 1.0 atau 1.1, akan InvalidOperationException dilemparkan. Kategori penghitung kinerja yang dibuat dengan versi sebelumnya menggunakan memori bersama global, dan nilai untuk InstanceLifetime harus Global. Jika kategori tidak digunakan oleh aplikasi yang berjalan pada versi 1.0 atau 1.1 dari .NET Framework, hapus dan buat ulang kategori.