ObjectCache.Add 메서드

정의

파생 클래스에서 재정의되는 경우 일치하는 키가 있는 기존 캐시 항목을 반환할 필요 없이 캐시 엔트리를 캐시에 삽입합니다.

오버로드

Name Description
Add(CacheItem, CacheItemPolicy)

파생 클래스에서 재정의된 경우 캐시 항목을 인스턴스로 CacheItem 캐시에 삽입하고 항목을 제거하는 방법에 대한 세부 정보를 추가합니다.

Add(String, Object, DateTimeOffset, String)

파생 클래스에서 재정의되는 경우 기존 캐시 항목을 덮어쓰지 않고 캐시 항목을 캐시에 삽입합니다.

Add(String, Object, CacheItemPolicy, String)

파생 클래스에서 재정의되는 경우 캐시에 캐시 항목을 삽입하여 항목을 제거하는 방법에 대한 정보를 지정합니다.

설명

Add 메서드 오버로드는 동일한 키를 가진 기존 캐시 항목을 덮어쓰거나 제거하지 않고 캐시에 캐시 항목을 삽입하려고 합니다. 캐시 항목은 형식화된 CacheItem 개체 또는 제네릭 개체일 수 있습니다.

AddOrGetExisting 메서드 오버로드와 Add 메서드 오버로드는 한 가지 중요한 차이점이 있습니다. 이러한 메서드가 캐시 항목을 삽입할 때 일치하는 항목이 캐시 AddOrGetExisting 에 있으면 메서드 오버로드가 기존 캐시 항목을 반환하지만 Add 메서드 오버로드는 반환하지 않습니다. 이러한 다양한 메서드 오버로드를 사용하면 호출자가 기존 캐시 항목이 필요한지 여부에 따라 코드를 최적화할 수 있습니다. 분산 캐시에서 메서드를 사용하여 기존 값을 반환하는 것이 메서드를 사용하여 AddOrGetExistingAdd 부울 값을 반환하는 것보다 더 비쌀 수 있습니다.

Add(CacheItem, CacheItemPolicy)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs

파생 클래스에서 재정의된 경우 캐시 항목을 인스턴스로 CacheItem 캐시에 삽입하고 항목을 제거하는 방법에 대한 세부 정보를 추가합니다.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);
public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);
abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

매개 변수

item
CacheItem

추가할 개체입니다.

policy
CacheItemPolicy

캐시 항목에 대한 제거 세부 정보가 들어 있는 개체입니다. 이 개체는 단순 절대 만료보다 더 많은 제거 옵션을 제공합니다.

반품

true 삽입에 성공했거나 false 캐시에 키가 item같은 항목이 이미 있는 경우 .

설명

메서드가 Add 내부적으로 호출ObjectCache하기 때문에 Add 메서드 오버로드는 클래스에서 AddOrGetExisting 가상(추상이 아님)입니다. 이렇게 하면 캐시 구현자가 제공해야 하는 메서드 오버로드 수가 줄어듭니다. 캐시 구현에 메서드에 대한 특별한 동작이 Add 필요하지 않은 경우 메서드 오버로드만 구현할 AddOrGetExisting 수 있습니다.

적용 대상

Add(String, Object, DateTimeOffset, String)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs

파생 클래스에서 재정의되는 경우 기존 캐시 항목을 덮어쓰지 않고 캐시 항목을 캐시에 삽입합니다.

public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);
abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool
Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

매개 변수

key
String

캐시 항목에 대한 고유 식별자입니다.

value
Object

삽입할 개체입니다.

absoluteExpiration
DateTimeOffset

캐시 항목이 만료되는 고정 날짜 및 시간입니다. 이 매개 변수는 메서드를 호출할 Add 때 필요합니다.

regionName
String

Optional. 지역이 구현된 경우 캐시 항목을 추가할 수 있는 캐시의 명명된 지역입니다. 지역은 .NET Framework 4에서 구현되지 않으므로 기본값은 null.

반품

true 삽입에 성공했거나 false 캐시에 키가 key같은 항목이 이미 있는 경우 .

설명

메서드가 Add 내부적으로 호출ObjectCache하기 때문에 Add 메서드 오버로드는 클래스에서 AddOrGetExisting 가상(추상이 아님)입니다. 이렇게 하면 캐시 구현자가 제공해야 하는 메서드 오버로드 수가 줄어듭니다. 캐시 구현에 메서드에 대한 특별한 동작이 Add 필요하지 않은 경우 메서드 오버로드만 구현할 AddOrGetExisting 수 있습니다.

적용 대상

Add(String, Object, CacheItemPolicy, String)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
ObjectCache.cs

파생 클래스에서 재정의되는 경우 캐시에 캐시 항목을 삽입하여 항목을 제거하는 방법에 대한 정보를 지정합니다.

public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);
abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

매개 변수

key
String

캐시 항목에 대한 고유 식별자입니다.

value
Object

삽입할 개체입니다.

policy
CacheItemPolicy

캐시 항목에 대한 제거 세부 정보가 들어 있는 개체입니다. 이 개체는 단순 절대 만료보다 더 많은 제거 옵션을 제공합니다.

regionName
String

Optional. 지역이 구현된 경우 캐시 항목을 추가할 수 있는 캐시의 명명된 지역입니다. 선택적 매개 변수의 기본값은 .입니다 null.

반품

true 삽입 시도가 성공하거나 false 캐시에 키가 key같은 항목이 이미 있는 경우 .

설명

메서드가 Add 내부적으로 호출ObjectCache하기 때문에 Add 메서드 오버로드는 클래스에서 AddOrGetExisting 가상(추상이 아님)입니다. 이렇게 하면 캐시 구현자가 제공해야 하는 메서드 오버로드 수가 줄어듭니다. 캐시 구현에 메서드에 대한 특별한 동작이 Add 필요하지 않은 경우 메서드 오버로드만 구현할 AddOrGetExisting 수 있습니다.

적용 대상