Cache.Insert Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставка элемента в объект Cache. Для перезаписи существующего элемента Cache с тем же параметром key используется одна из версий данного метода.
Перегрузки
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Вставка объекта в объект 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 -> unitPublic 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
Делегат, который, будучи предоставленным, будет вызываться при удалении объекта из кэша. Его можно использовать для уведомления приложений при удалении объектов из кэша.
Исключения
Значение параметра key или параметра value — null.
Для параметра slidingExpiration указывается значение меньше TimeSpan.Zero или больше одного года.
Оба параметра — 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.
См. также раздел
Применяется к
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 -> unitPublic 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
Делегат, который будет вызываться перед удалением объекта из кэша. Можно использовать этот вызов для обновления кэшируемого элемента, с тем чтобы он не был удален из кэша.
Исключения
Параметр key, value или onUpdateCallback имеет значение null.
Для параметра slidingExpiration указывается значение меньше TimeSpan.Zero или больше одного года.
Оба параметра — absoluteExpiration и slidingExpiration — заданы для элемента, который вы пытаетесь добавить в Cache.
-или-
Параметр dependencies имеет значение null, параметру absoluteExpiration присвоено значение NoAbsoluteExpiration, а параметру slidingExpiration — NoSlidingExpiration.
Комментарии
Метод Insert позволяет вставить новый элемент в кэш и предоставить делегат, который вызывается перед удалением элемента из кэша. В делегате можно обновить кэшированный элемент и тем самым предотвратить его удаление из кэша.
Этот метод перезапишет существующий Cache элемент тем же key параметром.
Нельзя задать параметры absoluteExpiration и slidingExpiration . Если предполагается, что срок действия элемента кэша истекает в определенное время, задайте absoluteExpiration для параметра значение определенного времени, а slidingExpiration для параметра — значение NoSlidingExpiration.
Если предполагается, что срок действия элемента кэша истекает через заданный период времени с момента последнего доступа к элементу slidingExpiration , для параметра устанавливается интервал истечения срока действия, а параметру absoluteExpiration — значение NoAbsoluteExpiration.
См. также раздел
Применяется к
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 -> unitPublic 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, значением NoSlidingExpirationскользящего срока действия и абсолютным значением NoAbsoluteExpirationсрока действия .
См. также раздел
Применяется к
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 -> unitPublic 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, значением скользящего срока действия 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 -> unitPublic 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.
Исключения
Значение параметра key или параметра value — null.
Для параметра slidingExpiration указывается значение меньше TimeSpan.Zero или больше одного года.
Оба параметра — 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.
