PerformanceCounter.Decrement Metod

Definition

Minskar den associerade prestandaräknaren med en genom en effektiv atomisk åtgärd.

public:
 long Decrement();
public long Decrement();
member this.Decrement : unit -> int64
Public Function Decrement () As Long

Returer

Det minskande räknarvärdet.

Undantag

Räknaren är skrivskyddad, så programmet kan inte minska den.

-eller-

Instansen är inte korrekt associerad med en prestandaräknare.

-eller-

Egenskapen InstanceLifetime är inställd på Process när du använder globalt delat minne.

Ett fel uppstod vid åtkomst till ett system-API.

Kommentarer

Du kan bara skriva till anpassade räknare. Alla systemräknare är skrivskyddade.

Anteckning

Metoderna Increment, IncrementByoch Decrement använder förreglar för att uppdatera räknarvärdet. Detta hjälper till att hålla räknarvärdet korrekt i scenarier med flera processer eller multiprocesser, men resulterar också i en prestandastraff. Om du inte behöver den noggrannhet som förreglade åtgärder ger, kan du uppdatera RawValue egenskapen direkt för upp till en prestandaförbättring på upp till fem gånger. Men i flertrådade scenarier kan vissa uppdateringar av räknarvärdet ignoreras, vilket resulterar i felaktiga data.

Anteckning

Om värdet för egenskapen InstanceLifetime är Process och prestandaräknarens kategori skapades med .NET Framework version 1.0 eller 1.1 genereras en InvalidOperationException. Prestandaräknarekategorier som skapats med tidigare versioner använder globalt delat minne och värdet för InstanceLifetime måste vara Global. Om kategorin inte används av program som körs på version 1.0 eller 1.1 av .NET Framework tar du bort och återskapar kategorin.

Gäller för

Trådsäkerhet

Den här metoden är trådsäker.