PerformanceCounter.Decrement Metode
Definisi
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.
Mengurangi penghitung kinerja terkait satu per satu melalui operasi atom yang efisien.
public:
long Decrement();
public long Decrement ();
member this.Decrement : unit -> int64
Public Function Decrement () As Long
Mengembalikan
Nilai penghitung yang direkrementasi.
Pengecualian
Penghitung bersifat baca-saja, sehingga aplikasi tidak dapat menguranginya.
-atau-
Instans tidak dikaitkan dengan penghitung kinerja dengan benar.
-atau-
Properti InstanceLifetime diatur ke Process saat menggunakan memori bersama global.
Terjadi kesalahan saat mengakses API sistem.
Keterangan
Anda hanya dapat menulis ke penghitung kustom. Semua penghitung sistem bersifat baca-saja.
Catatan
Metode Increment, IncrementBy, dan Decrement menggunakan interlock untuk memperbarui nilai penghitung. Ini membantu menjaga nilai penghitung tetap akurat dalam skenario multithreaded atau multiprocess, tetapi juga menghasilkan penalti performa. Jika Anda tidak memerlukan akurasi yang disediakan operasi yang saling mengunci, Anda dapat memperbarui RawValue properti secara langsung hingga 5 kali peningkatan performa. Namun, dalam skenario multithreaded, beberapa pembaruan pada nilai penghitung mungkin diabaikan, yang mengakibatkan data yang tidak akurat.
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.
Berlaku untuk
Keamanan Thread
Metode ini aman untuk utas.