Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Метод

public:
 System::Object ^ Add(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 object Add (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.Add : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> obj

Public Function Add (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback) As Object

Параметры

Возвращаемое значение

Object

Объект, представляющий добавленный элемент, если элемент был сохранен в кэше ранее; в противном случае — значение null.An object that represents the item that was added if the item was previously stored in the cache; otherwise, null.

Исключения

Примеры

В следующем примере создается AddItemToCache метод.The following example creates an AddItemToCache method. При вызове этого метода он устанавливает itemRemoved свойство в значение false и регистрирует onRemove метод с новым экземпляром CacheItemRemovedCallback делегата.When this method is called, it sets an itemRemoved property to false and registers an onRemove method with a new instance of the CacheItemRemovedCallback delegate. Сигнатура делегата используется в RemovedCallback методе.The delegate's signature is used in the RemovedCallback method. AddItemToCacheЗатем метод проверяет значение, связанное с Key1 ключом в кэше.The AddItemToCache method then checks the value associated with the Key1 key in the cache. Если значение равно null , Add метод помещает элемент в кэш с ключом Key1 , значением Value 1 , абсолютным сроком действия 60 секунд и высоким приоритетом кэша.If the value is null, the Add method places an item in the cache with a key of Key1, a value of Value 1, an absolute expiration of 60 seconds, and a high cache priority. В нем также используется onRemove метод в качестве аргумента.It also uses the onRemove method as an argument. Это позволяет RemovedCallback вызывать метод при удалении этого элемента из кэша.This allows the RemovedCallback method to be called when this item is removed from the cache.

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}

Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

Комментарии

Вызовы этого метода будут завершаться сбоем автоматически, если элемент с таким же key параметром уже сохранен в Cache .Calls to this method will fail silently if an item with the same key parameter is already stored in the Cache. Чтобы перезаписать существующий Cache элемент с помощью того же key параметра, используйте Insert метод.To overwrite an existing Cache item using the same key parameter, use the Insert method.

Нельзя задать оба absoluteExpiration slidingExpiration параметра и.You cannot set both the absoluteExpiration and slidingExpiration parameters. Если вы планируете истечение срока действия элемента кэша в определенное время, задайте absoluteExpiration параметру определенное время, а параметр — значение slidingExpiration NoSlidingExpiration .If you intend the cache item to expire at a specific time, you set the absoluteExpiration parameter to the specific time, and the slidingExpiration parameter to NoSlidingExpiration.

Если вы собираетесь истечь срок действия элемента кэша по истечении определенного промежутка времени с момента последнего обращения к элементу, задайте slidingExpiration для параметра значение интервал, а absoluteExpiration для параметра — значение NoAbsoluteExpiration .If you intend the cache item to expire after a certain amount of time has passed since the item was last accessed, you set the slidingExpiration parameter to the expiration interval, and the absoluteExpiration parameter to NoAbsoluteExpiration.

Применяется к

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

• CacheDependency
• CacheItemPriority
• CacheItemRemovedCallback
• Кэширование данных приложенияCaching Application Data