Cache.Insert 메서드

정의

Cache 개체에 항목을 삽입합니다. 동일한 key 매개 변수를 사용하는 기존 Cache 항목을 이 메서드의 버전 중 하나를 사용하여 덮어씁니다.

오버로드

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

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

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

종속성, 만료 정책, 항목이 캐시에서 제거되기 전에 애플리케이션에 알리는 데 사용할 수 있는 대리자와 함께 Cache 개체에 개체를 삽입합니다.

Insert(String, Object, CacheDependency)

파일 또는 키 종속성이 포함된 개체를 Cache에 삽입합니다.

Insert(String, Object)

해당 위치를 참조하는 캐시 키와 Cache 열거형이 제공하는 기본값을 사용하여 CacheItemPriority 개체에 항목을 삽입합니다.

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

종속성 및 만료 정책이 포함된 개체를 Cache에 삽입합니다.

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

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

public:
 void Insert(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 void Insert (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.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)

매개 변수

key
String

개체를 참조하는 데 사용되는 캐시 키입니다.

value
Object

캐시에 삽입될 개체입니다.

dependencies
CacheDependency

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

absoluteExpiration
DateTime

삽입된 개체가 만료되고 캐시에서 제거되는 시간입니다. 표준 시간에서 일광 절약 시간으로 변경하는 경우 현지 시간에 문제가 발생하지 않도록 하려면 이 매개 변수 값으로 UtcNow 대신 Now를 사용합니다. 절대 만료를 사용하는 경우 slidingExpiration 매개 변수가 NoSlidingExpiration이어야 합니다.

slidingExpiration
TimeSpan

삽입된 개체에 마지막으로 액세스한 시간과 해당 개체가 만료되는 시간 사이의 간격입니다. 이 값이 20분에 해당하는 경우 개체는 마지막으로 액세스하고 나서 20분 후에 만료되어 캐시에서 제거됩니다. 상대(sliding) 만료를 사용하는 경우 absoluteExpiration 매개 변수가 NoAbsoluteExpiration이어야 합니다.

priority
CacheItemPriority

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

onRemoveCallback
CacheItemRemovedCallback

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

예외

key 또는 value 매개 변수가 null인 경우

slidingExpiration 매개 변수를 TimeSpan.Zero 미만으로 설정하거나 1년을 넘게 설정한 경우

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

예제

다음 예제에서는 애플리케이션에 삽입할 때 항목에 높은 우선 순위를 할당 하는 방법에 설명 Cache 개체입니다.

참고

이 메서드를 사용 하는 방법에 대 한 자세한 합니다 CacheItemRemovedCallback 대리자를 참조 하세요 방법:는 애플리케이션은 항목에서에서 제거 됩니다 캐시 알림합니다.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)

설명

이 메서드는 동일한 key 매개 변수를 사용하여 기존 Cache 항목을 덮어씁 수 있습니다.

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

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

추가 정보

적용 대상

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

종속성, 만료 정책, 항목이 캐시에서 제거되기 전에 애플리케이션에 알리는 데 사용할 수 있는 대리자와 함께 Cache 개체에 개체를 삽입합니다.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);
member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)

매개 변수

key
String

개체를 참조하는 데 사용되는 캐시 키입니다.

value
Object

캐시에 삽입할 개체입니다.

dependencies
CacheDependency

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

absoluteExpiration
DateTime

삽입된 개체가 만료되고 캐시에서 제거되는 시간입니다. 표준 시간에서 일광 절약 시간으로 변경하는 경우 현지 시간에 문제가 발생하지 않도록 하려면 이 매개 변수 값으로 UtcNow 대신 Now를 사용합니다. 절대 만료를 사용하는 경우 slidingExpiration 매개 변수를 NoSlidingExpiration으로 설정해야 합니다.

slidingExpiration
TimeSpan

캐시된 개체에 마지막으로 액세스한 시간과 해당 개체가 만료되는 시간 사이의 간격입니다. 이 값이 20분에 해당하는 경우 개체는 마지막으로 액세스하고 나서 20분 후에 만료되어 캐시에서 제거됩니다. 상대(sliding) 만료를 사용하는 경우 absoluteExpiration 매개 변수를 NoAbsoluteExpiration으로 설정해야 합니다.

onUpdateCallback
CacheItemUpdateCallback

캐시에서 개체가 제거되기 전에 호출되는 대리자입니다. 이 대리자를 사용하여 캐시된 항목을 업데이트하고 이 항목이 캐시에서 제거되지 않았는지 확인할 수 있습니다.

예외

key, value 또는 onUpdateCallback 매개 변수는 null입니다.

slidingExpiration 매개 변수를 TimeSpan.Zero 미만으로 설정하거나 1년을 넘게 설정한 경우

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

또는

dependencies 매개 변수가 null이고 absoluteExpiration 매개 변수가 NoAbsoluteExpiration으로 설정되고 slidingExpiration 매개 변수가 NoSlidingExpiration으로 설정된 경우

설명

메서드 Insert 를 사용하면 캐시에 새 항목을 삽입하고 캐시에서 항목을 제거하기 전에 호출되는 대리자를 제공할 수 있습니다. 대리자에서 캐시된 항목을 업데이트하여 캐시에서 제거되지 않도록 할 수 있습니다.

이 메서드는 동일한 key 매개 변수를 사용하여 기존 Cache 항목을 덮어씁 수 있습니다.

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

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

추가 정보

적용 대상

Insert(String, Object, CacheDependency)

파일 또는 키 종속성이 포함된 개체를 Cache에 삽입합니다.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies);
member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency)

매개 변수

key
String

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

value
Object

캐시에 삽입될 개체입니다.

dependencies
CacheDependency

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

예외

key 또는 value 매개 변수가 null인 경우

예제

다음 예제에서는 XML 구성 파일에 대 한 캐시 종속성을 사용 하 여 애플리케이션의 캐시에 항목을 삽입 하는 방법에 설명 합니다.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

설명

이 메서드는 키가 매개 변수와 일치하는 key 기존 캐시 항목을 덮어씁니다. 메서드의 Insert 이 오버로드를 사용하여 캐시에 추가된 개체는 우선 순위Default, 슬라이딩 만료 값, 의 절대 만료 값NoSlidingExpirationNoAbsoluteExpiration으로 삽입됩니다.

추가 정보

적용 대상

Insert(String, Object)

해당 위치를 참조하는 캐시 키와 Cache 열거형이 제공하는 기본값을 사용하여 CacheItemPriority 개체에 항목을 삽입합니다.

public:
 void Insert(System::String ^ key, System::Object ^ value);
public void Insert (string key, object value);
member this.Insert : string * obj -> unit
Public Sub Insert (key As String, value As Object)

매개 변수

key
String

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

value
Object

캐시에 삽입될 개체입니다.

예외

key 또는 value 매개 변수가 null인 경우

예제

다음 예제에서는 애플리케이션의 캐시에 항목을 삽입 하는 방법에 설명 합니다.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

설명

이 메서드는 키가 매개 변수와 일치하는 key 기존 캐시 항목을 덮어씁니다. 메서드의 Insert 이 오버로드를 사용하여 캐시에 추가된 개체는 파일 또는 캐시 종속성, 우선 순위Default, 의 슬라이딩 만료 값 및 의 절대 만료 값 NoSlidingExpirationNoAbsoluteExpiration없이 삽입됩니다.

추가 정보

적용 대상

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

종속성 및 만료 정책이 포함된 개체를 Cache에 삽입합니다.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);
member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)

매개 변수

key
String

개체를 참조하는 데 사용되는 캐시 키입니다.

value
Object

캐시에 삽입될 개체입니다.

dependencies
CacheDependency

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

absoluteExpiration
DateTime

삽입된 개체가 만료되고 캐시에서 제거되는 시간입니다. 표준 시간에서 일광 절약 시간으로 변경하는 경우 현지 시간에 문제가 발생하지 않도록 하려면 이 매개 변수 값으로 UtcNow 대신 Now를 사용합니다. 절대 만료를 사용하는 경우 slidingExpiration 매개 변수가 NoSlidingExpiration이어야 합니다.

slidingExpiration
TimeSpan

삽입된 개체에 마지막으로 액세스한 시간과 해당 개체가 만료되는 시간 사이의 간격입니다. 이 값이 20분에 해당하는 경우 개체는 마지막으로 액세스하고 나서 20분 후에 만료되어 캐시에서 제거됩니다. 상대(sliding) 만료를 사용하는 경우 absoluteExpiration 매개 변수가 NoAbsoluteExpiration이어야 합니다.

예외

key 또는 value 매개 변수가 null인 경우

slidingExpiration 매개 변수를 TimeSpan.Zero 미만으로 설정하거나 1년을 넘게 설정한 경우

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

예제

다음 예제에서는 절대 만료를 사용 하 여 애플리케이션의 캐시에 항목을 삽입 하는 방법에 설명 합니다.

참고

이 형식의 Insert 메서드는 캐시 종속성을 지원하므로 항목에 종속성이 없는 경우 쉼표로 구분된 매개 변수 목록에서 매개 변수를 (NothingVisual Basic의 경우)로 null 선언 dependency 해야 합니다.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

다음 예제에서는 슬라이딩 만료를 사용하여 캐시에 항목을 삽입하는 방법을 보여 줍니다.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

설명

이 메서드는 동일한 key 매개 변수를 사용하여 기존 Cache 항목을 덮어씁 수 있습니다.

매개 변수가 로 slidingExpiration 설정된 NoSlidingExpiration경우 슬라이딩 만료가 비활성화됩니다. 매개 변수를 slidingExpiration 보다 ZeroabsoluteExpiration 큼으로 설정하면 매개 변수가 매개 변수에 Now 포함된 값과 함께 로 설정됩니다slidingExpiration. 매개 변수에 지정된 absoluteExpiration 시간 전에 캐시에서 항목을 요청하면 항목이 캐시에 다시 배치되고 absoluteExpiration 매개 변수에 포함된 slidingExpiration 값과 함께 로 다시 설정 DateTime.Now 됩니다. 매개 변수의 날짜 absoluteExpiration 이전에 캐시에서 항목을 요청하지 않으면 항목이 캐시에서 제거됩니다. insert 메서드의 이 오버로드를 사용하여 캐시에 추가된 항목은 우선 순위 Default로 삽입됩니다.

추가 정보

적용 대상