<forcePerformanceCounterUniqueSharedMemoryReads> Element

Artikel
05/10/2023

Hiermee geeft u op of PerfCounter.dll de registerinstelling CategoryOptions gebruikt in een .NET Framework versie 1.1-toepassing om te bepalen of prestatiemeteritems moeten worden geladen uit categoriespecifiek gedeeld geheugen of globaal geheugen.

<configuratie>
<Runtime>
<forcePerformanceCounterUniqueSharedMemoryReads>

Syntax

<forcePerformanceCounterUniqueSharedMemoryReads
enabled="true|false"/>

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
`enabled`	Vereist kenmerk. Geeft aan of PerfCounter.dll de registerinstelling CategoryOptions gebruikt om te bepalen of prestatiemeteritems moeten worden geladen uit categoriespecifiek gedeeld geheugen of globaal geheugen.

ingeschakeld kenmerk

Waarde	Beschrijving
`false`	PerfCounter.dll gebruikt niet de registerinstelling CategoryOptions Dit is de standaardinstelling.
`true`	PerfCounter.dll gebruikt de registerinstelling CategoryOptions.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element	Beschrijving
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`runtime`	Bevat informatie over assemblybinding en garbagecollection.

Opmerkingen

In versies van de .NET Framework vóór de .NET Framework 4 kwam de versie van PerfCounter.dll die is geladen overeen met de runtime die in het proces is geladen. Als op een computer zowel de .NET Framework versie 1.1 als de .NET Framework 2.0 is geïnstalleerd, zou een .NET Framework 1.1-toepassing de .NET Framework 1.1-versie van PerfCounter.dll laden. Vanaf de .NET Framework 4 wordt de nieuwste geïnstalleerde versie van PerfCounter.dll geladen. Dit betekent dat een .NET Framework 1.1-toepassing de .NET Framework 4-versie van PerfCounter.dll laadt als de .NET Framework 4 op de computer is geïnstalleerd.

Vanaf de .NET Framework 4 controleert PerfCounter.dll bij het gebruik van prestatiemeteritems de registervermelding CategoryOptions voor elke provider om te bepalen of deze moet worden gelezen uit categoriespecifiek gedeeld geheugen of globaal gedeeld geheugen. De .NET Framework 1.1 PerfCounter.dll leest deze registervermelding niet, omdat het niet op de hoogte is van categoriespecifiek gedeeld geheugen; het leest altijd uit het algemene gedeelde geheugen.

Voor compatibiliteit met eerdere versies controleert de .NET Framework 4 PerfCounter.dll de registervermelding CategoryOptions niet wanneer deze wordt uitgevoerd in een .NET Framework 1.1-toepassing. Het maakt gewoon gebruik van globaal gedeeld geheugen, net als de .NET Framework 1.1 PerfCounter.dll. U kunt de .NET Framework 4-PerfCounter.dll echter instrueren om de registerinstelling te controleren door het <forcePerformanceCounterUniqueSharedMemoryReads> element in te schakelen.

Notitie

Het inschakelen van het <forcePerformanceCounterUniqueSharedMemoryReads> element garandeert niet dat categoriespecifiek gedeeld geheugen wordt gebruikt. Als de instelling is ingeschakeld op true , verwijst PerfCounter.dll alleen naar de registerinstelling CategoryOptions. De standaardinstelling voor CategoryOptions is het gebruik van categoriespecifiek gedeeld geheugen; U kunt echter CategoryOptions wijzigen om aan te geven dat globaal gedeeld geheugen moet worden gebruikt.

De registersleutel die de instelling CategoryOptions bevat, is HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\<categoryName>\Performance. CategoryOptions is standaard ingesteld op 3, waarmee PerfCounter.dll wordt geïnstrueerd om categoriespecifiek gedeeld geheugen te gebruiken. Als CategoryOptions is ingesteld op 0, gebruikt PerfCounter.dll globaal gedeeld geheugen. Instantiegegevens worden alleen opnieuw gebruikt als de naam van het exemplaar dat wordt gemaakt, identiek is aan het exemplaar dat opnieuw wordt gebruikt. Alle versies kunnen naar de categorie schrijven. Als CategoryOptions is ingesteld op 1, wordt globaal gedeeld geheugen gebruikt, maar kunnen exemplaargegevens opnieuw worden gebruikt als de categorienaam dezelfde lengte heeft als de categorie die opnieuw wordt gebruikt.

De instellingen 0 en 1 kunnen leiden tot geheugenlekken en het opvullen van het geheugen van de prestatiemeteritems.

Voorbeeld

In het volgende voorbeeld ziet u hoe u opgeeft dat PerfCounter.dll moet verwijzen naar de registervermelding CategoryOptions om te bepalen of deze categoriespecifiek gedeeld geheugen moet gebruiken.

<configuration>  
  <runtime>  
    <forcePerformanceCounterUniqueSharedMemoryReads enabled="true"/>  
  </runtime>  
</configuration>

Delen via