Udostępnij za pośrednictwem

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

  • Artykuł

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>

Zobacz też