PerformanceCounter.Increment Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Sumber:

PerformanceCounter.cs

Menaikkan penghitung kinerja terkait satu per satu melalui operasi atom yang efisien.

public:
 long Increment();

public long Increment ();

member this.Increment : unit -> int64

Public Function Increment () As Long

Mengembalikan

Int64

Nilai penghitung yang ditambah.

Pengecualian

InvalidOperationException

Penghitung bersifat baca-saja, sehingga aplikasi tidak dapat menaikkannya.

-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 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.

Keamanan Thread

Metode ini aman untuk utas.