<namedCaches> 요소 (캐시 설정)

아티클
04/08/2023

명명된 MemoryCache 인스턴스에 대한 구성 설정 컬렉션을 지정합니다. 합니다 NamedCaches 하나 이상의 구성 설정의 컬렉션을 참조 하는 속성 namedCaches 구성 파일의 요소입니다.

<configuration>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

Syntax

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

Type

None

특성 및 요소

다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	Description
`cacheMemoryLimitMegabytes`	MemoryCache의 인스턴스가 커질 수 있는 최대 허용 크기(MB)를 지정하는 정수 값입니다. 기본값은 0이며, 이는 MemoryCache 클래스의 자동 크기 조정 추론이 기본적으로 사용됨을 의미합니다.
`name`	캐시의 이름입니다.
`physicalMemoryLimitPercentage`	캐시에서 사용할 수 있는 실제로 설치된 컴퓨터 메모리의 최대 백분율을 지정하는 0에서 100 사이의 정수 값입니다. 기본값은 0이며, 이는 MemoryCache 클래스의 자동 크기 조정 추론이 기본적으로 사용됨을 의미합니다.
`pollingInterval`	캐시 구현이 현재 메모리 로드를 캐시 인스턴스에 대해 설정된 절대 및 백분율 기반 메모리 제한과 비교하기까지의 시간 간격을 나타내는 값입니다. 이 값은 "HH:MM:SS" 형식으로 입력됩니다.

자식 요소

요소	Description
<add>	메모리 캐시용으로 명명된 캐시를 `namedCaches` 컬렉션에 추가합니다.
<clear>	메모리 캐시에 대해 `namedCaches` 컬렉션을 지웁니다.
<remove>	메모리 캐시용으로 명명된 캐시 항목을 `namedCaches` 컬렉션에서 제거합니다.

부모 요소

요소	Description
<구성>	공용 언어 런타임 및 .NET Framework 애플리케이션에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다.
<memoryCache>	MemoryCache 클래스를 기반으로 하는 캐시 구성에 사용되는 요소를 정의합니다.
<system.runtime.caching>	.NET Framework에 기본 제공되는 애플리케이션에서 출력 캐싱을 구현할 수 있는 형식이 포함되어 있습니다.

설명

Web.config 파일의 메모리 캐시 구성 섹션에는 namedCaches 컬렉션에 대한 add, remove 및 clear 특성이 포함될 수 있습니다. 각 namedCaches 항목은 name 특성으로 고유하게 식별됩니다.

애플리케이션 구성 파일의 정보를 참조하여 메모리 캐시 항목의 인스턴스를 검색할 수 있습니다. 기본적으로 기본 캐시 인스턴스에만 구성 파일에 항목이 있습니다. 기본 캐시 인스턴스는 Default 속성에서 반환되는 인스턴스입니다.

name 특성을 "기본값"으로 설정하면 요소는 기본 메모리 캐시 인스턴스를 사용합니다.

예제

다음 예에서는 name 특성을 "기본값"으로 설정하여 캐시 이름을 기본 캐시 항목 이름으로 설정하는 방법을 보여 줍니다.

cacheMemoryLimitMegabytes 특성 및 physicalMemoryPercentage 특성은 0으로 설정됩니다. 이러한 특성을 0으로 설정하면 MemoryCache 클래스의 자동 크기 조정 추론이 사용됩니다. 캐시 구현은 현재 메모리 로드를 2분마다 절대 및 백분율 기반 메모리 제한과 비교합니다.

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