<element memoryCache> (nastavení mezipaměti)

Článek
05/09/2023

Definuje prvek, který se používá ke konfiguraci mezipaměti založené na MemoryCache třídě . Třída MemoryCacheElement definuje element memoryCache , který můžete použít ke konfiguraci mezipaměti. V jedné aplikaci lze použít více instancí MemoryCache třídy . Každý memoryCache prvek v konfiguračním souboru může obsahovat nastavení pro pojmenovanou MemoryCache instanci.

<Konfigurace>
<System.runtime.caching>
<Memorycache>

Syntax

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

Typ

MemoryCache Třída.

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
`CacheMemoryLimitMegabytes`	Maximální velikost paměti v megabajtech, na kterou může instance objektu MemoryCache zvětšovat. Výchozí hodnota je 0, což znamená, že MemoryCache se ve výchozím nastavení používají heuristika automatické velikosti třídy.
`Name`	Název konfigurace mezipaměti.
`PhysicalMemoryLimitPercentage`	Procento fyzické paměti, které může mezipaměť používat. Výchozí hodnota je 0, což znamená, že MemoryCache se ve výchozím nastavení používají heuristika automatické velikosti třídy.
`PollingInterval`	Hodnota označující časový interval, po jehož uplynutí implementace mezipaměti porovná aktuální zatížení paměti s absolutními a procentuálními limity paměti, které jsou nastaveny pro instanci mezipaměti. Hodnota se zadává ve formátu HH:MM:SS.

Podřízené elementy

Element	Popis
<pojmenované mezipaměti>	Obsahuje kolekci nastavení konfigurace pro `namedCache` instanci.

Nadřazené elementy

Element	Popis
<Konfigurace>	Určuje kořenový prvek v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
<System.runtime.caching>	Obsahuje typy, které umožňují implementovat ukládání výstupu do mezipaměti v aplikacích, které jsou integrovány do rozhraní .NET Framework.

Poznámky

Třída MemoryCache je konkrétní implementací abstraktní ObjectCache třídy. Instance třídy mohou být dodány MemoryCache s konfiguračními informacemi z konfiguračních souborů aplikace. Oddíl konfigurace memoryCache obsahuje kolekci namedCaches konfigurace.

Při inicializaci objektu mezipaměti založeného na paměti se nejprve pokusí najít namedCaches položku, která odpovídá názvu v parametru, který je předán konstruktoru mezipaměti paměti. Pokud se namedCaches najde položka, z konfiguračního souboru se načtou informace o dotazování a správě paměti.

Proces inicializace pak určí, zda byly přepsány nějaké položky konfigurace, pomocí volitelné kolekce dvojic název/hodnota konfiguračních informací v konstruktoru. Pokud v kolekci páru název/hodnota předáte některou z následujících hodnot, přepíší tyto hodnoty informace získané z konfiguračního souboru:

Příklad

Následující příklad ukazuje, jak nastavit název objektu MemoryCache na výchozí název objektu mezipaměti nastavením atributu name na "Default".

Atribut cacheMemoryLimitMegabytes a atribut jsou nastaveny physicalMemoryLimitPercentage na nulu. Nastavení těchto atributů na nulu MemoryCache znamená, že se ve výchozím nastavení použijí heuristika automatické velikosti. Implementace mezipaměti by měla každé dvě minuty porovnávat aktuální zatížení paměti s absolutními a procentuálními limity paměti.

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