<memoryCache-element> (cacheinställningar)

Artikel
04/08/2023

Definierar ett element som används för att konfigurera en cache som baseras på MemoryCache klassen . Klassen MemoryCacheElement definierar ett memoryCache-element som du kan använda för att konfigurera cachen. Flera instanser av MemoryCache klassen kan användas i ett enda program. Varje memoryCache element i konfigurationsfilen kan innehålla inställningar för en namngiven MemoryCache instans.

<Konfiguration>
<system.runtime.caching>
<memoryCache>

Syntax

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

Typ

MemoryCache Klass.

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	Beskrivning
`CacheMemoryLimitMegabytes`	Den maximala minnesstorlek i MEGABYTE som en instans av ett MemoryCache objekt kan växa till. Standardvärdet är 0, vilket innebär att MemoryCache klassens heuristik för automatisk storlek används som standard.
`Name`	Namnet på cachekonfigurationen.
`PhysicalMemoryLimitPercentage`	Procentandelen fysiskt minne som kan användas av cachen. Standardvärdet är 0, vilket innebär att MemoryCache klassens heuristik för automatisk storlek används som standard.
`PollingInterval`	Ett värde som anger det tidsintervall efter vilket cacheimplementeringen jämför den aktuella minnesbelastningen med de absoluta och procentbaserade minnesgränser som har angetts för cacheinstansen. Värdet anges i formatet "HH:MM:SS".

Underordnade element

Element	Beskrivning
<namedCaches>	Innehåller en samling konfigurationsinställningar för instansen `namedCache` .

Överordnade element

Element	Beskrivning
<Konfiguration>	Anger rotelementet i varje konfigurationsfil som används av den vanliga språkkörningen och .NET Framework program.
<system.runtime.caching>	Innehåller typer som gör att du kan implementera cachelagring av utdata i program som är inbyggda i .NET Framework.

Kommentarer

Klassen MemoryCache är en konkret implementering av den abstrakta ObjectCache klassen. Instanser av MemoryCache klassen kan levereras med konfigurationsinformation från programkonfigurationsfiler. Konfigurationsavsnittet memoryCache innehåller en namedCaches konfigurationssamling.

När ett minnesbaserat cacheobjekt initieras försöker det först hitta en namedCaches post som matchar namnet i parametern som skickas till konstruktorn för minnescachen. Om en namedCaches post hittas hämtas avsöknings- och minneshanteringsinformationen från konfigurationsfilen.

Initieringsprocessen avgör sedan om några konfigurationsposter åsidosatts, med hjälp av den valfria samlingen med namn-/värdepar med konfigurationsinformation i konstruktorn. Om du skickar något av följande värden i namn/värde-parsamlingen åsidosätter dessa värden information som hämtas från konfigurationsfilen:

Exempel

I följande exempel visas hur du anger namnet MemoryCache på objektet till standardnamnet för cacheobjektet genom att ange name attributet till "Standard".

Attributet cacheMemoryLimitMegabytes och attributet är inställda på physicalMemoryLimitPercentage noll. Om du anger dessa attribut till noll används heuristiken MemoryCache för automatisk storlek som standard. Cacheimplementeringen bör jämföra den aktuella minnesbelastningen med de absoluta och procentbaserade minnesgränserna varannan minut.

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

Dela via