Cache.Insert Метод

Определение

Пространство имен:

System.Web.Caching

Сборка:

System.Web.dll

Вставка элемента в объект Cache. Для перезаписи существующего элемента Cache с тем же параметром key используется одна из версий данного метода.

Перегрузки

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 указывается значение меньше 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.

Если предполагается, что срок действия элемента кэша истекает через некоторое время с момента последнего доступа к элементу, задайте slidingExpiration для параметра интервал истечения срока действия, а absoluteExpiration параметру — значение NoAbsoluteExpiration.

См. также раздел

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Кэширование данных приложения

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 минут после последнего обращения. Если используется скользящий срок действия, параметру absoluteExpiration следует присвоить значение NoAbsoluteExpiration.

onUpdateCallback

CacheItemUpdateCallback

Делегат, который будет вызываться перед удалением объекта из кэша. Можно использовать этот вызов для обновления кэшируемого элемента, с тем чтобы он не был удален из кэша.

Исключения

ArgumentNullException

Параметр key, value или onUpdateCallback имеет значение null.

ArgumentOutOfRangeException

Для параметра slidingExpiration указывается значение меньше TimeSpan.Zero или больше одного года.

ArgumentException

Оба параметра — absoluteExpiration и slidingExpiration — заданы для элемента, который вы пытаетесь добавить в Cache.

-или-

Параметр dependencies имеет значение null, параметру absoluteExpiration присвоено значение NoAbsoluteExpiration, а параметру slidingExpiration — NoSlidingExpiration.

Комментарии

Метод Insert позволяет вставить новый элемент в кэш и предоставить делегат, который вызывается перед удалением элемента из кэша. В делегате можно обновить кэшированный элемент и тем самым предотвратить его удаление из кэша.

Этот метод перезапишет существующий Cache элемент тем же key параметром.

Нельзя задать параметры absoluteExpiration и slidingExpiration . Если предполагается, что срок действия элемента кэша истекает в определенное время, задайте absoluteExpiration для параметра значение определенного времени, а slidingExpiration для параметра — значение NoSlidingExpiration.

Если предполагается, что срок действия элемента кэша истекает по истечении заданного периода времени с момента последнего доступа к элементу slidingExpiration , необходимо задать для параметра интервал истечения срока действия, а параметру — absoluteExpiration значение NoAbsoluteExpiration.

См. также раздел

• 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

Зависимости файла или ключа кэша для вставленного объекта. Если какая-либо зависимость меняется, объект становится недопустимым и удаляется из кэша. Если зависимости отсутствуют, данный параметр имеет значение null.

absoluteExpiration

DateTime

Время истечения срока действия вставленного объекта и его удаления из кэша. Чтобы избежать возможных проблем с местным временем, например перехода от стандартного времени к летнему, используйте для этого параметра значение UtcNow, а не Now. Если используется абсолютный срок действия, параметр slidingExpiration должен быть NoSlidingExpiration.

slidingExpiration

TimeSpan

Интервал между временем последнего обращения к вставленному объекту и временем истечения срока действия этого объекта. Если это значение равно 20 минутам, срок действия объекта истекает и он удаляется из кэша через 20 минут после последнего обращения. Если используется скользящий срок действия, параметр absoluteExpiration должен быть NoAbsoluteExpiration.

Исключения

ArgumentNullException

Значение параметра key или параметра value — null.

ArgumentOutOfRangeException

Для параметра slidingExpiration указывается значение меньше TimeSpan.Zero или больше одного года.

ArgumentException

Оба параметра — absoluteExpiration и slidingExpiration — заданы для элемента, который вы пытаетесь добавить в Cache.

Примеры

В следующем примере показано, как вставить элемент в кэш приложения с абсолютным сроком действия.

Примечание

Так как эта форма Insert метода поддерживает зависимости кэша, если у элемента нет зависимостей, необходимо объявить dependency параметр как null (Nothing в Visual Basic) в списке параметров, разделенном запятыми.

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 значение больше Zero, параметру absoluteExpiration присваивается Now значение плюс значение, содержащееся в параметре slidingExpiration . Если элемент запрашивается из кэша до времени, указанного параметром absoluteExpiration , он снова будет помещен в кэш и absoluteExpiration будет снова установлен DateTime.Now в плюс значение, содержащееся в параметре slidingExpiration . Если элемент не запрашивается из кэша до даты в параметре absoluteExpiration , он удаляется из кэша. Элемент, добавленный в кэш с помощью этой перегрузки метода insert, вставляется с приоритетом Default.

См. также раздел

• DateTime
• TimeSpan
• Кэширование данных приложения