MemoryCache.Set 메서드

정의

네임스페이스:: System.Runtime.Caching

어셈블리:: System.Runtime.Caching.dll

패키지:: System.Runtime.Caching v11.0.0-preview.4.26230.115

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

캐시에 캐시 항목을 삽입합니다.

오버로드

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

설명

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

Set(CacheItem, CacheItemPolicy)

Source:: MemoryCache.cs

Source:: MemoryCache.cs

Source:: MemoryCache.cs

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

캐시 항목에 대한 인수의 잘못된 조합이 전달되었습니다. 이 문제는 캐시 항목에 대한 정책 개체에 다음 만료 세부 정보가 설정된 경우에 발생합니다.

개체의 절대 만료 값과 슬라이딩 만료 값 CacheItemPolicy 이 모두 기본값 InfiniteAbsoluteExpiration 과 NoSlidingExpiration 필드가 아닌 값으로 설정된 경우 클래스는 MemoryCache 절대 만료 및 슬라이딩 만료를 기반으로 만료 정책을 설정할 수 없습니다. 클래스를 사용할 MemoryCache 때는 하나의 만료 설정만 명시적으로 설정할 수 있습니다. 다른 설정은 속성으로 InfiniteAbsoluteExpiration NoSlidingExpiration 설정해야 합니다.
개체에 대해 제거 콜백과 업데이트 콜백을 모두 지정하는 CacheItemPolicy 경우 클래스는 MemoryCache 캐시 항목당 하나의 콜백 유형만 사용할 수 있습니다.

ArgumentOutOfRangeException

속성이 SlidingExpiration .보다 Zero작은 값으로 설정됩니다.

-또는-

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

-또는-

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

설명

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

적용 대상

Set(String, Object, DateTimeOffset, String)

Source:: MemoryCache.cs

Source:: MemoryCache.cs

Source:: MemoryCache.cs

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

캐시 항목을 추가할 수 있는 캐시의 명명된 지역입니다. 이 매개 변수에 대한 값을 전달하지 마세요. 클래스가 null 지역을 구현하지 않으므로 이 매개 변수는 기본적으로 MemoryCache 사용됩니다.

예외

NotSupportedException

regionName 가 아닙니다 null.

ArgumentNullException

key은 null입니다.

-또는-

value은 null입니다.

ArgumentException

캐시 항목에 대한 인수의 잘못된 조합이 전달되었습니다. 이 문제는 캐시 항목에 대한 정책 개체에 다음 만료 세부 정보가 설정된 경우에 발생합니다.
개체의 절대 만료 값과 슬라이딩 만료 값 CacheItemPolicy 이 모두 기본값 InfiniteAbsoluteExpiration 과 슬라이딩 만료 값이 아닌 값으로 설정된 경우 .NoSlidingExpiration 이는 클래스가 MemoryCache 절대 및 슬라이딩 만료를 기반으로 하는 만료 항목을 지원하지 않기 때문에 발생합니다. 클래스를 사용할 MemoryCache 때는 하나의 만료 설정만 명시적으로 설정할 수 있습니다. 다른 설정은 다음으로 InfiniteAbsoluteExpiration 설정해야 NoSlidingExpiration합니다.
개체에 제거 콜백과 업데이트 콜백을 모두 지정하는 CacheItemPolicy 경우 클래스는 MemoryCache 캐시 항목당 하나의 콜백 유형만 사용할 수 있습니다.

ArgumentOutOfRangeException

속성이 SlidingExpiration .보다 Zero작은 값으로 설정됩니다.

-또는-

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

-또는-

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

설명

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

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

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

적용 대상

Set(String, Object, CacheItemPolicy, String)

Source:: MemoryCache.cs

Source:: MemoryCache.cs

Source:: MemoryCache.cs

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

예외

ArgumentNullException

key은 null입니다.

-또는-

value가 null인 경우

-또는-

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

ArgumentException

캐시 항목에 대한 인수의 잘못된 조합이 있습니다. 이 문제는 캐시 항목에 대한 정책 개체에 다음 만료 세부 정보가 설정된 경우에 발생합니다.
개체의 절대 만료 값과 슬라이딩 만료 값 CacheItemPolicy 이 모두 기본값 InfiniteAbsoluteExpiration 과 슬라이딩 만료 값이 아닌 값으로 설정된 경우 .NoSlidingExpiration 이는 클래스가 MemoryCache 절대 및 슬라이딩 만료를 기반으로 하는 만료 항목을 지원하지 않기 때문입니다. 클래스를 사용할 MemoryCache 때는 하나의 만료 설정만 명시적으로 설정할 수 있습니다. 다른 설정은 다음으로 InfiniteAbsoluteExpiration 설정해야 NoSlidingExpiration합니다.
제거 콜백과 업데이트 콜백이 모두 클래스에 CacheItemPolicy 지정된 경우 클래스는 MemoryCache 캐시 항목당 하나의 콜백 유형만 사용할 수 있습니다.

ArgumentOutOfRangeException

속성이 SlidingExpiration .보다 Zero작은 값으로 설정됩니다.

-또는-

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

-또는-

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

NotSupportedException

regionName 가 아닙니다 null.

설명

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

적용 대상

피드백

이 페이지가 도움이 되었나요?