<het element memoryCache> (cache-instellingen)

Artikel
05/10/2023

Definieert een element dat wordt gebruikt voor het configureren van een cache die is gebaseerd op de MemoryCache klasse. De MemoryCacheElement klasse definieert een memoryCache-element dat u kunt gebruiken om de cache te configureren. Meerdere exemplaren van de MemoryCache klasse kunnen worden gebruikt in één toepassing. Elk memoryCache element in het configuratiebestand kan instellingen voor een benoemd MemoryCache exemplaar bevatten.

<configuratie>
<system.runtime.caching>
<memoryCache>

Syntax

<memoryCache>
    <namedCaches>  
        <!-- child elements -->  
    </namedCaches>
</memoryCache>

Type

MemoryCache Klasse.

Kenmerken en elementen

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

Kenmerken

Kenmerk	Beschrijving
`CacheMemoryLimitMegabytes`	De maximale geheugengrootte, in megabytes, waarmee een exemplaar van een MemoryCache object kan worden uitgebreid. De standaardwaarde is 0, wat betekent dat de automatische heuristiek van de MemoryCache klasse standaard wordt gebruikt.
`Name`	De naam van de cacheconfiguratie.
`PhysicalMemoryLimitPercentage`	Het percentage fysiek geheugen dat door de cache kan worden gebruikt. De standaardwaarde is 0, wat betekent dat de automatische heuristiek van de MemoryCache klasse standaard wordt gebruikt.
`PollingInterval`	Een waarde die het tijdsinterval aangeeft waarna de cache-implementatie de huidige geheugenbelasting vergelijkt met de absolute en op percentage gebaseerde geheugenlimieten die zijn ingesteld voor het cache-exemplaar. De waarde wordt ingevoerd in de indeling 'UU:MM:SS'.

Onderliggende elementen

Element	Beschrijving
<namedCaches>	Bevat een verzameling configuratie-instellingen voor het `namedCache` exemplaar.

Bovenliggende elementen

Element	Beschrijving
<configuratie>	Hiermee geeft u het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
<system.runtime.caching>	Bevat typen waarmee u uitvoercaching kunt implementeren in toepassingen die zijn ingebouwd in de .NET Framework.

Opmerkingen

De MemoryCache klasse is een concrete implementatie van de abstracte ObjectCache klasse. Exemplaren van de MemoryCache klasse kunnen worden geleverd met configuratiegegevens uit toepassingsconfiguratiebestanden. De sectie memoryCache-configuratie bevat een namedCaches configuratieverzameling.

Wanneer een cacheobject op basis van geheugen wordt geïnitialiseerd, wordt eerst geprobeerd een namedCaches vermelding te vinden die overeenkomt met de naam in de parameter die wordt doorgegeven aan de geheugencacheconstructor. Als er een namedCaches vermelding wordt gevonden, worden de polling- en geheugenbeheergegevens opgehaald uit het configuratiebestand.

Het initialisatieproces bepaalt vervolgens of eventuele configuratie-vermeldingen zijn overschreven, met behulp van de optionele verzameling van naam-waardeparen met configuratiegegevens in de constructor. Als u een van de volgende waarden doorgeeft in de verzameling naam/waarde-paar, overschrijven deze waarden de informatie die is verkregen uit het configuratiebestand:

Voorbeeld

In het volgende voorbeeld ziet u hoe u de naam van het MemoryCache object instelt op de standaardnaam van het cacheobject door het name kenmerk in te stellen op 'Standaard'.

Het cacheMemoryLimitMegabytes kenmerk en het physicalMemoryLimitPercentage kenmerk zijn ingesteld op nul. Als u deze kenmerken op nul instelt, betekent dit dat de MemoryCache automatische heuristiek standaard wordt gebruikt. De cache-implementatie moet elke twee minuten de huidige geheugenbelasting vergelijken met de absolute geheugenlimieten en op basis van een percentage.

<configuration>  
  <system.runtime.caching>  
    <memoryCache>  
      <namedCaches>  
          <add name="Default"
               cacheMemoryLimitMegabytes="0"
               physicalMemoryLimitPercentage="0"  
               pollingInterval="00:02:00" />  
      </namedCaches>  
    </memoryCache>  
  </system.runtime.caching>  
</configuration>

Delen via