Cache.Insert 메서드

정의

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

어셈블리:: System.Web.dll

중요

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

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

오버로드

Name	Description
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분 후에 캐시에서 제거됩니다. 슬라이딩 만료를 사용하는 경우 매개 변수는 absoluteExpiration .이어야 NoAbsoluteExpiration합니다.

priority: CacheItemPriority

열거형으로 표현된 대로 캐시에 저장된 다른 항목을 기준으로 하는 개체의 CacheItemPriority 비용입니다. 이 값은 개체를 제거하면 캐시에서 사용됩니다. 비용이 더 낮은 개체는 더 높은 비용을 가진 개체보다 앞에 캐시에서 제거됩니다.

onRemoveCallback: CacheItemRemovedCallback

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

매개 변수를 slidingExpiration 1년보다 TimeSpan.Zero 작거나 같은 값으로 설정합니다.

ArgumentException

absoluteExpiration 및 slidingExpiration 매개 변수는 모두 추가하려는 항목에 Cache대해 설정됩니다.

예제

다음 예제에서는 애플리케이션의 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)

설명

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

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

항목에 대한 마지막 액세스 이후 특정 시간이 경과한 후 캐시 항목이 만료되도록 하려면 매개 변수를 만료 간격으로 설정하고 매개 변수를 <a0/>로 설정합니다.

추가 정보

적용 대상

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

absoluteExpiration: DateTime

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

slidingExpiration: TimeSpan

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

onUpdateCallback: CacheItemUpdateCallback

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

매개 변수를 slidingExpiration 1년보다 TimeSpan.Zero 작거나 같은 값으로 설정합니다.

ArgumentException

absoluteExpiration 및 slidingExpiration 매개 변수는 모두 추가하려는 항목에 Cache대해 설정됩니다.

-또는-

매개 변수는 dependenciesnull,이고 absoluteExpiration 매개 변수는 로 NoAbsoluteExpiration설정되고 slidingExpiration 매개 변수는 .로 NoSlidingExpiration설정됩니다.

설명

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

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

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

추가 정보

CacheItemUpdateCallback

적용 대상

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.

예외

ArgumentNullException

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, 슬라이딩 만료 값 NoSlidingExpiration및 절대 만료 값 NoAbsoluteExpiration으로 삽입됩니다.

추가 정보

CacheDependency

적용 대상

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

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

예외

ArgumentNullException

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

예제

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

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

설명

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

추가 정보

애플리케이션 데이터 캐싱

적용 대상

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

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

매개 변수를 slidingExpiration 1년보다 TimeSpan.Zero 작거나 같은 값으로 설정합니다.

ArgumentException

absoluteExpiration 및 slidingExpiration 매개 변수는 모두 추가하려는 항목에 Cache대해 설정됩니다.

예제

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

메모

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

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))

설명

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

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

추가 정보

적용 대상

피드백

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