<memoryCache> , element (ustawienia pamięci podręcznej)

Artykuł
05/09/2023

Definiuje element używany do konfigurowania pamięci podręcznej opartej MemoryCache na klasie. Klasa MemoryCacheElement definiuje element memoryCache , którego można użyć do skonfigurowania pamięci podręcznej. Wiele wystąpień MemoryCache klasy może być używanych w jednej aplikacji. Każdy memoryCache element w pliku konfiguracji może zawierać ustawienia nazwanego MemoryCache wystąpienia.

<Konfiguracji>
<system.runtime.caching>
<Memorycache>

Składnia

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

Typ

MemoryCache Klasa.

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
`CacheMemoryLimitMegabytes`	Maksymalny rozmiar pamięci w megabajtach, do którego może wzrosnąć wystąpienie MemoryCache obiektu. Wartość domyślna to 0, co oznacza, że MemoryCache heurystyka automatycznego rozmiaru klasy jest domyślnie używana.
`Name`	Nazwa konfiguracji pamięci podręcznej.
`PhysicalMemoryLimitPercentage`	Procent pamięci fizycznej, która może być używana przez pamięć podręczną. Wartość domyślna to 0, co oznacza, że MemoryCache heurystyka automatycznego rozmiaru klasy jest domyślnie używana.
`PollingInterval`	Wartość wskazująca interwał czasu, po którym implementacja pamięci podręcznej porównuje bieżące obciążenie pamięci z bezwzględnymi i procentowymi limitami pamięci ustawionymi dla wystąpienia pamięci podręcznej. Wartość jest wprowadzana w formacie "HH:MM:SS".

Elementy podrzędne

Element	Opis
<Namedcaches>	Zawiera kolekcję ustawień konfiguracji dla `namedCache` wystąpienia.

Elementy nadrzędne

Element	Opis
<Konfiguracji>	Określa element główny w każdym pliku konfiguracji, który jest używany przez środowisko uruchomieniowe języka wspólnego i .NET Framework aplikacji.
<system.runtime.caching>	Zawiera typy, które umożliwiają implementowanie buforowania danych wyjściowych w aplikacjach wbudowanych w .NET Framework.

Uwagi

Klasa MemoryCache jest konkretną implementacją klasy abstrakcyjnej ObjectCache . MemoryCache Wystąpienia klasy mogą być dostarczane z informacjami o konfiguracji z plików konfiguracji aplikacji. Sekcja konfiguracji pamięciCache zawiera namedCaches kolekcję konfiguracji.

Gdy obiekt pamięci podręcznej jest inicjowany, najpierw próbuje znaleźć namedCaches wpis zgodny z nazwą w parametrze przekazywanym do konstruktora pamięci podręcznej. Jeśli zostanie znaleziony namedCaches wpis, informacje dotyczące sondowania i zarządzania pamięcią są pobierane z pliku konfiguracji.

Następnie proces inicjowania określa, czy jakiekolwiek wpisy konfiguracji zostały zastąpione przy użyciu opcjonalnej kolekcji par nazw/wartości informacji o konfiguracji w konstruktorze. Jeśli przekażesz jedną z następujących wartości w kolekcji par nazw/wartości, te wartości zastępują informacje uzyskane z pliku konfiguracji:

Przykład

W poniższym przykładzie pokazano, jak ustawić nazwę MemoryCache obiektu na domyślną nazwę obiektu pamięci podręcznej, ustawiając name atrybut na "Default".

Atrybut cacheMemoryLimitMegabytes i physicalMemoryLimitPercentage atrybut są ustawione na zero. Ustawienie tych atrybutów na zero oznacza, że MemoryCache autoskalowanie heurystyki jest domyślnie używane. Implementacja pamięci podręcznej powinna porównać bieżące obciążenie pamięci z limitami pamięci bezwzględnej i procentowej co dwie minuty.

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

Udostępnij za pośrednictwem