PerformanceCounter.Increment Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Исходный код:

PerformanceCounter.cs

Увеличивает связанный счетчик производительности по одному через эффективную атомарную операцию.

public:
 long Increment();

public long Increment();

member this.Increment : unit -> int64

Public Function Increment () As Long

Возвращаемое значение

Int64

Добавочное значение счетчика.

Исключения

InvalidOperationException

Счетчик доступен только для чтения, поэтому приложение не может увеличить его.

–или–

Экземпляр неправильно связан с счетчиком производительности.

–или–

Для InstanceLifetime свойства задано Process значение при использовании глобальной общей памяти.

Win32Exception

Ошибка при доступе к системным API.

Комментарии

Вы можете записывать только пользовательские счетчики. Все системные счетчики доступны только для чтения.

Замечание

IncrementByМетоды Incrementи Decrement методы используют взаимоблокировки для обновления значения счетчика. Это помогает обеспечить точность счетчика в многопоточных или многопроцессных сценариях, но также приводит к штрафу производительности. Если вам не нужна точность, которая обеспечивает заблокированные операции, можно обновить RawValue свойство непосредственно до 5 раз. Однако в многопоточных сценариях некоторые обновления значения счетчика могут игнорироваться, что приводит к неточным данным.

Замечание

Если для свойства задано Process значение InstanceLifetime и категория счетчика производительности была создана с помощью .NET Framework версии 1.0 или 1.1, InvalidOperationException создается исключение. Категории счетчиков производительности, созданные с использованием предыдущих версий, используют глобальную общую память, а значение InstanceLifetime должно быть Global. Если категория не используется приложениями, работающими в версиях 1.0 или 1.1 платформы .NET Framework, удалите и повторно создайте категорию.

Потокобезопасность

Этот метод является потокобезопасной.