<namedCaches> – element (nastavení mezipaměti)

Článek
05/09/2023

Určuje kolekci nastavení konfigurace pro pojmenované MemoryCache instance. Vlastnost NamedCaches odkazuje na kolekci nastavení konfigurace z jednoho nebo více namedCaches prvků konfiguračního souboru.

<Konfigurace>
  <System.runtime.caching>
    <Memorycache>
      <pojmenované mezipaměti>

Syntax

<namedCaches>  
  <add name="Default"/>
</namedCaches>

Typ

None

Atributy a elementy

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

Atributy

Atribut	Popis
`cacheMemoryLimitMegabytes`	Celočíselná hodnota, která určuje maximální povolenou velikost v megabajtech, na kterou může instance objektu MemoryCache zvětšovat. Výchozí hodnota je 0, což znamená, že se ve výchozím nastavení používají heuristika automatické velikosti MemoryCache třídy.
`name`	Název mezipaměti.
`physicalMemoryLimitPercentage`	Celočíselná hodnota mezi 0 a 100, která určuje maximální procento fyzicky nainstalované paměti počítače, kterou může mezipaměť využívat. Výchozí hodnota je 0, což znamená, že se ve výchozím nastavení používají heuristika automatické velikosti MemoryCache třídy.
`pollingInterval`	Hodnota, která označuje č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. Tato hodnota se zadává ve formátu HH:MM:SS.

Podřízené elementy

Element	Popis
<Přidat>	Přidá do `namedCaches` kolekce pojmenovanou mezipaměť pro mezipaměť paměti.
<Jasné>	Vymaže kolekci `namedCaches` pro mezipaměť paměti.
<Odebrat>	Odebere z `namedCaches` kolekce pojmenovanou položku mezipaměti pro mezipaměť paměti.

Nadřazené elementy

Element	Popis
<Konfigurace>	Určuje kořenový prvek v každém konfiguračním souboru, který se používá v modulu CLR (Common Language Runtime) a aplikacích rozhraní .NET Framework.
<Memorycache>	Definuje prvek, který se používá ke konfiguraci mezipaměti, která je založená na MemoryCache třídě.
<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

Oddíl konfigurace mezipaměti paměti Web.config souboru může obsahovat addatributy , removea clear pro kolekci namedCaches . Každá namedCaches položka je jedinečně identifikována atributem name .

Instance položek mezipaměti paměti můžete načíst odkazem na informace v konfiguračních souborech aplikace. Ve výchozím nastavení má v konfiguračním souboru záznam pouze výchozí instance mezipaměti. Výchozí instance mezipaměti je instance, která je vrácena Default z vlastnosti.

Pokud nastavíte atribut name na "Default", element použije výchozí instanci mezipaměti paměti.

Příklad

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

Atribut cacheMemoryLimitMegabytes a physicalMemoryPercentage atribut jsou nastaveny na nulu. Nastavení těchto atributů na nulu znamená, že se používají heuristika automatické velikosti MemoryCache třídy. Implementace mezipaměti porovnává aktuální zatížení paměti s absolutními a procentuálními limity paměti každé dvě minuty.

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