MemoryCache.AddOrGetExisting 메서드

정의

네임스페이스:

System.Runtime.Caching

어셈블리:

System.Runtime.Caching.dll

패키지:

System.Runtime.Caching v9.0.0

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

오버로드

AddOrGetExisting(CacheItem, CacheItemPolicy)	지정된 CacheItem 인스턴스와 캐시 엔트리를 제거하는 방법에 대한 정보를 사용하여 캐시 엔트리를 캐시에 추가합니다.
AddOrGetExisting(String, Object, DateTimeOffset, String)	지정된 키와 값 및 절대 만료 값을 사용하여 캐시 엔트리를 캐시에 추가합니다.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	지정된 키와 값 및 캐시 엔트리를 제거하는 방법에 대한 지정된 정보를 사용하여 캐시 엔트리를 캐시에 삽입합니다.

설명

AddOrGetExisting 메서드 오버로드는 캐시에 캐시 항목을 삽입하는 데 사용됩니다. 일치하는 키가 있는 캐시 항목이 없는 경우 이러한 메서드는 새 항목을 삽입합니다. 일치 하는 키를 사용 하 여 캐시 엔트리를 이미 있는 경우 기존 항목을 반환 합니다.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Source:

MemoryCache.cs

지정된 CacheItem 인스턴스와 캐시 엔트리를 제거하는 방법에 대한 정보를 사용하여 캐시 엔트리를 캐시에 추가합니다.

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

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

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

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

매개 변수

item

CacheItem

추가할 개체입니다.

policy

CacheItemPolicy

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

반환

CacheItem

키가 같은 캐시 엔트리가 있으면 기존 캐시 엔트리이고, 그렇지 않으면 null입니다.

예외

ArgumentNullException

Value 속성은 null입니다.

ArgumentException

절대 및 CacheItemPolicy 개체의 슬라이딩 만료 값 모두 InfiniteAbsoluteExpiration 및 NoSlidingExpiration 필드의 기본값 이외의 값으로 설정됩니다. MemoryCache 클래스는 절대 만료와 슬라이딩(sliding) 만료의 조합을 기준으로 만료 정책을 설정할 수 없습니다. MemoryCache 인스턴스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 만료 설정은 InfiniteAbsoluteExpiration 필드 또는 NoSlidingExpiration 필드로 설정되어야 합니다.

ArgumentOutOfRangeException

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

또는

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

또는

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

설명

매개 변수는 item 메서드에서 사용되는 키와 값을 제공합니다. 캐시에 매개 변수의 키와 동일한 키를 가진 캐시 항목이 item 있는 경우 메서드는 기존 항목을 CacheItem instance 반환합니다. 기존 캐시 항목이 없는 경우 메서드는 매개 변수에서 제공하는 키와 값을 사용하고 에서 지정policy한 item 제거 세부 정보를 사용하여 새 캐시 항목을 만듭니다.

경고

Add 및 AddOrGetExisting 메서드 오버로드는 UpdateCallback 속성을 지원하지 않습니다. 따라서 캐시 엔트리에 대한 UpdateCallback 속성을 설정하려면 대신 Set 메서드 오버로드를 사용하십시오.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Source:

MemoryCache.cs

지정된 키와 값 및 절대 만료 값을 사용하여 캐시 엔트리를 캐시에 추가합니다.

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

override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

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

매개 변수

key

String

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

value

Object

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

absoluteExpiration

DateTimeOffset

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

regionName

String

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

반환

Object

키가 같은 캐시 엔트리가 있으면 기존 캐시 엔트리이고, 그렇지 않으면 null입니다.

예외

ArgumentNullException

value이 null가 아닙니다.

NotSupportedException

regionName이 null가 아닙니다.

ArgumentException

절대 및 CacheItemPolicy 개체의 슬라이딩 만료 값 모두 InfiniteAbsoluteExpiration 및 NoSlidingExpiration 필드의 기본값 이외의 값으로 설정됩니다. MemoryCache 클래스는 절대 만료와 슬라이딩(sliding) 만료의 조합을 기준으로 만료 정책을 설정할 수 없습니다. MemoryCache 인스턴스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 만료 설정은 InfiniteAbsoluteExpiration 또는 NoSlidingExpiration으로 설정되어야 합니다.

ArgumentOutOfRangeException

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

또는

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

또는

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

설명

캐시에 키가 매개 변수와 일치하는 key 캐시 항목이 없으면 새 캐시 항목이 만들어지고 메서드 오버로드가 MemoryCache.AddOrGetExisting 를 반환합니다 null. 일치하는 캐시 항목이 있으면 기존 항목이 반환됩니다.

경고

Add 및 AddOrGetExisting 메서드 오버로드는 UpdateCallback 속성을 지원하지 않습니다. 따라서 캐시 엔트리에 대한 UpdateCallback 속성을 설정하려면 대신 Set 메서드 오버로드를 사용하십시오.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Source:

MemoryCache.cs

지정된 키와 값 및 캐시 엔트리를 제거하는 방법에 대한 지정된 정보를 사용하여 캐시 엔트리를 캐시에 삽입합니다.

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

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

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

매개 변수

key

String

추가하거나 가져올 캐시 엔트리의 고유 식별자입니다.

value

Object

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

policy

CacheItemPolicy

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

regionName

String

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

반환

Object

일치하는 캐시 엔트리가 이미 있으면 캐시 엔트리이고, 그렇지 않으면 null입니다.

예외

ArgumentNullException

value이(가) null인 경우

ArgumentException

절대 및 CacheItemPolicy 개체의 슬라이딩 만료 값 모두 InfiniteAbsoluteExpiration 및 NoSlidingExpiration의 기본값 이외의 값으로 설정됩니다. MemoryCache 클래스는 절대 만료와 슬라이딩(sliding) 만료의 조합을 기준으로 만료 정책을 설정할 수 없습니다. MemoryCache 클래스를 사용하면 만료 설정을 하나만 명시적으로 설정할 수 있습니다. 다른 설정은 InfiniteAbsoluteExpiration 또는 NoSlidingExpiration으로 설정되어야 합니다.

또는

CacheItemPolicy 개체에 대해 제거 콜백 및 업데이트 콜백을 모두 지정했습니다. MemoryCache는 캐시 항목당 한 가지 형식의 콜백을 사용하는 것만 지원합니다.

ArgumentOutOfRangeException

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

또는

SlidingExpiration이 1년보다 큰 값으로 설정되었습니다.

또는

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

설명

경고

Add 및 AddOrGetExisting 메서드 오버로드는 UpdateCallback 속성을 지원하지 않습니다. 따라서 캐시 엔트리에 대한 UpdateCallback 속성을 설정하려면 대신 Set 메서드 오버로드를 사용하십시오.