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

Метод Cache.Insert (String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

 

Опубликовано: Октябрь 2016

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

Пространство имен:   System.Web.Caching
Сборка:  System.Web (в System.Web.dll)

public void Insert(
	string key,
	object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemUpdateCallback onUpdateCallback
)

Параметры

key
Type: System.String

Ключ кэша, используемый для ссылки на объект.

value
Type: System.Object

Объект для вставки в кэш.

dependencies
Type: System.Web.Caching.CacheDependency

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

absoluteExpiration
Type: System.DateTime

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

slidingExpiration
Type: System.TimeSpan

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

onUpdateCallback
Type: System.Web.Caching.CacheItemUpdateCallback

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

Exception Condition
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.

.NET Framework
Доступно с 2.0
Вернуться в начало
Показ: