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