다음을 통해 공유


Cache.Add 메서드

정의

종속성, 만료 및 우선 순위 정책과, 삽입된 항목이 Cache에서 제거되는 경우 애플리케이션에 알리는 데 사용할 수 있는 대리자를 통해, 지정된 항목을 Cache 개체에 추가합니다.

public:
 System::Object ^ Add(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);
public object Add (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);
member this.Add : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> obj
Public Function Add (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback) As Object

매개 변수

key
String

항목을 참조하는 데 사용되는 캐시 키입니다.

value
Object

캐시에 추가할 항목입니다.

dependencies
CacheDependency

항목에 대한 파일 또는 캐시 키 종속성입니다. 종속성이 변경되면 해당 개체는 사용할 수 없게 되어 캐시에서 제거됩니다. 종속성이 없는 경우 이 매개 변수에는 null이 포함됩니다.

absoluteExpiration
DateTime

추가된 개체가 만료되고 캐시에서 제거되는 시간입니다. 상대(sliding) 만료를 사용하는 경우 absoluteExpiration 매개 변수가 NoAbsoluteExpiration이어야 합니다.

slidingExpiration
TimeSpan

추가된 개체에 마지막으로 액세스한 시간과 해당 개체가 만료되는 시간 사이의 간격입니다. 이 값이 20분인 경우 해당 개체에 마지막으로 액세스한 후 20분이 경과되면 개체가 만료되고 캐시에서 제거됩니다. 절대 만료를 사용하는 경우 slidingExpiration 매개 변수가 NoSlidingExpiration이어야 합니다.

priority
CacheItemPriority

CacheItemPriority 열거형으로 표현되는, 개체에 대한 상대 비용입니다. 캐시에서는 개체를 제거할 때 이 값을 사용합니다. 비용이 저렴한 개체가 비용이 많이 드는 개체보다 캐시에서 먼저 제거됩니다.

onRemoveCallback
CacheItemRemovedCallback

대리자가 제공된 경우에는 캐시에서 개체가 제거될 때 이 대리자가 호출됩니다. 캐시에서 개체가 삭제될 때 이 대리자를 사용하여 애플리케이션에 알릴 수 있습니다.

반환

추가된 항목이 이미 캐시에 저장되어 있는 경우 해당 항목을 나타내는 개체이며, 그렇지 않으면 null입니다.

예외

key 또는 value 매개 변수가 null로 설정되어 있는 경우

slidingExpiration 매개 변수가 TimeSpan.Zero 미만 또는 1년 이상으로 설정된 경우

Cache에 추가하려는 항목에 absoluteExpirationslidingExpiration 매개 변수가 모두 설정된 경우

예제

다음 예제에서는 메서드를 AddItemToCache 만듭니다. 이 메서드가 호출되면 속성을 로 itemRemoved 설정하고 대리자의 새 인스턴스 CacheItemRemovedCallback 에 메서드를 등록합니다onRemove.false 대리자의 서명은 메서드에서 RemovedCallback 사용됩니다. 그런 다음 메서드는 AddItemToCache 캐시의 Key1 키와 연결된 값을 확인합니다. 값이 이 Add 면 메서드는 nullKey1, 값Value 1, 절대 만료 60초 및 높은 캐시 우선 순위로 캐시에 항목을 배치합니다. 또한 메서드를 onRemove 인수로 사용합니다. 이렇게 하면 이 항목이 RemovedCallback 캐시에서 제거될 때 메서드를 호출할 수 있습니다.

참고

사용 하는 방법에 대 한 예제는 CacheDependency 클래스 및 CacheItemRemovedCallback 대리자를 참조 하십시오 애플리케이션 데이터 캐싱합니다.

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}
Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

설명

동일한 key 매개 변수를 가진 항목이 이미 에 Cache저장된 경우 이 메서드에 대한 호출이 자동으로 실패합니다. 동일한 key 매개 변수를 사용하여 기존 Cache 항목을 덮어쓰려면 메서드를 Insert 사용합니다.

slidingExpiration 매개 변수를 absoluteExpiration 둘 다 설정할 수 없습니다. 캐시 항목이 특정 시간에 만료되도록 하려면 매개 변수를 absoluteExpiration 특정 시간으로 설정하고 매개 변수를 slidingExpirationNoSlidingExpiration설정합니다.

항목이 마지막으로 액세스된 후 일정 시간이 지난 후에 캐시 항목이 만료되도록 하려면 매개 변수를 만료 간격으로 설정하고 매개 변수를 absoluteExpirationNoAbsoluteExpiration설정합니다slidingExpiration.

적용 대상

추가 정보