PerformanceCounter.Increment Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Origine:

PerformanceCounter.cs

Incrementa il contatore delle prestazioni associato di uno tramite un'operazione atomica efficiente.

public:
 long Increment();

public long Increment();

member this.Increment : unit -> int64

Public Function Increment () As Long

Restituisce

Int64

Valore del contatore incrementato.

Eccezioni

InvalidOperationException

Il contatore è di sola lettura, quindi l'applicazione non può incrementarla.

oppure

L'istanza non è associata correttamente a un contatore delle prestazioni.

oppure

La InstanceLifetime proprietà viene impostata su Process quando si usa la memoria condivisa globale.

Win32Exception

Si è verificato un errore durante l'accesso a un'API di sistema.

Commenti

È possibile scrivere solo in contatori personalizzati. Tutti i contatori di sistema sono di sola lettura.

Annotazioni

I Incrementmetodi , IncrementBye Decrement usano interlock per aggiornare il valore del contatore. Ciò consente di mantenere accurato il valore del contatore negli scenari multithreading o multiprocesso, ma comporta anche una riduzione delle prestazioni. Se non è necessaria l'accuratezza specificata dalle operazioni interlocked, è possibile aggiornare direttamente la RawValue proprietà per un massimo di 5 volte il miglioramento delle prestazioni. Tuttavia, negli scenari multithreading alcuni aggiornamenti al valore del contatore potrebbero essere ignorati, causando dati non accurati.

Annotazioni

Se il valore della InstanceLifetime proprietà è Process e la categoria del contatore delle prestazioni è stata creata con .NET Framework versione 1.0 o 1.1, viene generata un'eccezione InvalidOperationException . Le categorie di contatori delle prestazioni create con le versioni precedenti usano la memoria condivisa globale e il valore per InstanceLifetime deve essere Global. Se la categoria non viene usata dalle applicazioni in esecuzione nelle versioni 1.0 o 1.1 di .NET Framework, eliminare e ricreare la categoria.

Thread safety

Questo metodo è thread-safe.