MemoryCache.Set 메서드

정의

네임스페이스:

System.Runtime.Caching

어셈블리:

System.Runtime.Caching.dll

패키지:

System.Runtime.Caching v8.0.0

캐시에 캐시 엔트리를 삽입합니다.

오버로드

Set(CacheItem, CacheItemPolicy)	CacheItem 인스턴스를 사용하여 캐시 엔트리의 키와 값을 제공하여 캐시 엔트리를 캐시에 삽입합니다.
Set(String, Object, DateTimeOffset, String)	키와 값을 사용하여 캐시 엔트리를 캐시에 삽입하고 시간 기반 만료 정보를 지정합니다.
Set(String, Object, CacheItemPolicy, String)	키와 값 및 제거 정보를 사용하여 캐시 엔트리를 캐시에 삽입합니다.

설명

지정된 항목이 없으면 생성됩니다. 지정된 항목이 있으면 업데이트됩니다.

Set(CacheItem, CacheItemPolicy)

Source:

MemoryCache.cs

CacheItem 인스턴스를 사용하여 캐시 엔트리의 키와 값을 제공하여 캐시 엔트리를 캐시에 삽입합니다.

public:
 override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override void Set (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

매개 변수

item

CacheItem

삽입할 캐시 엔트리를 나타내는 개체입니다.

policy

CacheItemPolicy

캐시 엔트리에 대한 제거 정보가 포함된 개체입니다. 이 개체는 간단한 절대 만료보다 많은 제거 옵션을 제공합니다.

예외

ArgumentNullException

item은 null입니다.

또는

Key 속성은 null입니다.

또는

Value 속성은 null입니다.

ArgumentException

캐시 엔트리에 잘못된 인수 조합이 전달되었습니다. 다음 만료 정보를 캐시 항목에 대한 정책 개체에 대해 설정한 경우 발생합니다.

• 개체의 절대 및 슬라이딩 만료 값이 모두 및 NoSlidingExpiration 필드의 CacheItemPolicy 기본값 InfiniteAbsoluteExpiration 이 아닌 값으로 설정된 경우 MemoryCache 클래스는 절대 만료와 슬라이딩(sliding) 만료를 기준으로 만료 정책을 설정할 수 없습니다. MemoryCache 클래스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 설정은 InfiniteAbsoluteExpiration 또는 NoSlidingExpiration 속성으로 설정해야 합니다.

• 개체에 대해 CacheItemPolicy 제거 콜백과 업데이트 콜백이 모두 지정된 경우 MemoryCache 클래스는 캐시 항목당 한 가지 형식의 콜백을 사용하는 것만 지원합니다.

ArgumentOutOfRangeException

SlidingExpiration 속성이 Zero보다 작은 값으로 설정된 경우

또는

SlidingExpiration 속성은 1년 보다 큰 값으로 설정됩니다.

또는

Priority이 CacheItemPriority 열거형의 값이 아닌 경우

설명

다른 Set 메서드 오버로드와 마찬가지로 메서드는 Set 동일한 키를 가진 항목이 이미 있는지 여부에 관계없이 항상 캐시에 캐시 값을 배치합니다. 지정된 항목이 캐시에 없으면 새 캐시 항목이 삽입됩니다. 지정된 항목이 이미 있는 경우 해당 값이 업데이트됩니다.

Set(String, Object, DateTimeOffset, String)

Source:

MemoryCache.cs

키와 값을 사용하여 캐시 엔트리를 캐시에 삽입하고 시간 기반 만료 정보를 지정합니다.

public override void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.Set : string * obj * DateTimeOffset * string -> unit

Public Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

매개 변수

key

String

삽입할 캐시 엔트리의 고유 식별자입니다.

value

Object

캐시 엔트리의 데이터입니다.

absoluteExpiration

DateTimeOffset

캐시 엔트리가 만료될 고정된 날짜 및 시간입니다.

regionName

String

캐시 엔트리를 추가할 수 있는 캐시의 명명된 영역입니다. 이 매개 변수의 값은 전달하지 마십시오. MemoryCache 클래스가 영역을 구현하지 않기 때문에 이 매개 변수는 기본적으로 null입니다.

예외

NotSupportedException

regionName이 null가 아닙니다.

ArgumentNullException

key이(가) null인 경우

또는

Value은 null입니다.

ArgumentException

• 캐시 엔트리에 잘못된 인수 조합이 전달되었습니다. 다음 만료 정보를 캐시 항목에 대한 정책 개체에 대해 설정한 경우 발생합니다.

• 개체의 절대 만료 값과 슬라이딩 만료 값 CacheItemPolicy 이 모두 및 NoSlidingExpiration의 InfiniteAbsoluteExpiration 기본값이 아닌 값으로 설정된 경우 MemoryCache 클래스가 절대 만료 및 슬라이딩(sliding) 만료에 따라 만료되는 항목을 지원하지 않기 때문에 발생합니다. MemoryCache 클래스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 설정은 InfiniteAbsoluteExpiration 또는 NoSlidingExpiration으로 설정되어야 합니다.

• 제거 콜백과 업데이트 콜백이 모두 개체에 CacheItemPolicy 지정된 경우 MemoryCache 클래스는 캐시 항목당 한 가지 형식의 콜백을 사용하는 것만 지원합니다.

ArgumentOutOfRangeException

SlidingExpiration 속성이 Zero보다 작은 값으로 설정된 경우

또는

SlidingExpiration 속성은 1년 보다 큰 값으로 설정됩니다.

또는

• Priority 속성은 CacheItemPriority 열거형의 값이 아닙니다.

설명

다른 Set 메서드 오버로드와 마찬가지로 메서드는 Set 항목이 동일한 키를 사용하여 이미 존재하는지 여부에 관계없이 항상 캐시에 캐시 값을 배치합니다. 지정된 항목이 없으면 새 캐시 항목이 삽입됩니다. 지정된 항목이 있으면 업데이트됩니다.

매개 변수는 absoluteExpiration 캐시에서 항목을 제거해야 하는 시기를 나타냅니다.

항목을 제거하면 연결된 변경 모니터가 트리거됩니다. 제거된 항목이 개체 또는 CacheItemRemovedCallback 개체와 CacheItemUpdateCallback 연결된 경우 콜백에 전달되는 제거 이유가 속성에 Removed 포함됩니다.

Set(String, Object, CacheItemPolicy, String)

Source:

MemoryCache.cs

키와 값 및 제거 정보를 사용하여 캐시 엔트리를 캐시에 삽입합니다.

public override void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

매개 변수

key

String

삽입할 캐시 엔트리의 고유 식별자입니다.

value

Object

캐시 엔트리의 데이터입니다.

policy

CacheItemPolicy

캐시 엔트리에 대한 제거 정보가 포함된 개체입니다. 이 개체는 간단한 절대 만료보다 많은 제거 옵션을 제공합니다.

regionName

String

캐시 엔트리를 추가할 수 있는 캐시의 명명된 영역입니다. 이 매개 변수의 값은 전달하지 마십시오. MemoryCache 클래스가 영역을 구현하지 않기 때문에 이 매개 변수는 기본적으로 null입니다.

예외

ArgumentNullException

key은 null입니다.

또는

value가 null인 경우

또는

UpdateCallback 속성의 도우미 메서드에 전달된 콜백 참조는 null입니다.

ArgumentException

• 캐시 항목에 대한 인수 조합이 잘못되었습니다. 다음 만료 정보를 캐시 항목에 대한 정책 개체에 대해 설정한 경우 발생합니다.

• 개체의 절대 만료 값과 슬라이딩 만료 값 CacheItemPolicy 이 모두 및 NoSlidingExpiration의 InfiniteAbsoluteExpiration 기본값이 아닌 값으로 설정된 경우 MemoryCache 클래스가 절대 만료 및 슬라이딩(sliding) 만료에 따라 만료되는 항목을 지원하지 않기 때문입니다. MemoryCache 클래스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 설정은 InfiniteAbsoluteExpiration 또는 NoSlidingExpiration으로 설정되어야 합니다.

• 제거 콜백과 업데이트 콜백이 모두 클래스에 CacheItemPolicy 지정된 경우. MemoryCache 클래스는 캐시 항목당 한 가지 형식의 콜백을 사용하는 것만 지원합니다.

ArgumentOutOfRangeException

SlidingExpiration 속성이 Zero보다 작은 값으로 설정된 경우

또는

SlidingExpiration 속성은 1년 보다 큰 값으로 설정됩니다.

또는

Priority 속성은 CacheItemPriority 열거형의 값이 아닙니다.

NotSupportedException

regionName이 null가 아닙니다.

설명

다른 Set 메서드 오버로드와 마찬가지로 메서드는 Set 일치하는 항목이 이미 있는지 여부에 관계없이 항상 캐시에 캐시 값을 배치합니다. 지정된 항목이 캐시에 없으면 새 캐시 항목이 삽입됩니다. 지정된 항목이 있으면 업데이트됩니다.

항목을 제거하면 연결된 변경 모니터가 트리거됩니다. 제거된 항목이 개체 또는 CacheItemRemovedCallback 개체와 CacheItemUpdateCallback 연결된 경우 콜백에 전달되는 제거 이유가 속성에 Removed 포함됩니다.