ObjectCache.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе вставляет запись кэша в кэш, не требуя возврата существующей записи кэша с соответствующим ключом.
Перегрузки
| Имя | Описание |
|---|---|
| Add(CacheItem, CacheItemPolicy) |
При переопределении в производном классе пытается вставить запись кэша в кэш в качестве CacheItem экземпляра и добавляет сведения о том, как следует вытеснить запись. |
| Add(String, Object, DateTimeOffset, String) |
При переопределении в производном классе вставляет запись кэша в кэш без перезаписи существующей записи кэша. |
| Add(String, Object, CacheItemPolicy, String) |
При переопределении в производном классе вставляет запись кэша в кэш, указывая сведения о том, как запись будет вытеснена. |
Комментарии
Перегрузки Add метода пытаются вставить запись кэша в кэш без перезаписи или удаления существующей записи кэша с тем же ключом. Запись кэша может быть типизированным CacheItem объектом или универсальным объектом.
Перегрузки AddOrGetExisting методов и Add перегрузки методов имеют одно значительное различие. Когда эти методы вставляют запись кэша, если соответствующая запись найдена в кэше, AddOrGetExisting перегрузки метода возвращают существующую запись кэша, но Add перегрузки метода не выполняются. Наличие этих разных перегрузок методов позволяет вызывающим пользователям оптимизировать свой код на основе того, требуется ли им существующую запись кэша. В распределенных кэшах возврат существующего значения с помощью AddOrGetExisting метода может быть дороже, чем возврат логическое значение с помощью Add метода.
Add(CacheItem, CacheItemPolicy)
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
При переопределении в производном классе пытается вставить запись кэша в кэш в качестве CacheItem экземпляра и добавляет сведения о том, как следует вытеснить запись.
public:
virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As BooleanПараметры
- item
- CacheItem
Добавляемый объект.
- policy
- CacheItemPolicy
Объект, содержащий сведения о вытеснения для записи кэша. Этот объект предоставляет больше возможностей для вытеснения, чем простой абсолютный срок действия.
Возвращаемое значение
true Значение , если вставка выполнена успешно, или false если в кэше уже есть запись, которая имеет тот же ключ, что itemи .
Комментарии
Add Перегрузки методов являются виртуальными (не абстрактными) для ObjectCache класса, так как Add метод внутренне вызываетAddOrGetExisting. Это уменьшает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует специального Add поведения для метода, она может просто реализовать AddOrGetExisting перегрузки метода.
Применяется к
Add(String, Object, DateTimeOffset, String)
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
При переопределении в производном классе вставляет запись кэша в кэш без перезаписи существующей записи кэша.
public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As BooleanПараметры
- key
- String
Уникальный идентификатор записи кэша.
- value
- Object
Объект для вставки.
- absoluteExpiration
- DateTimeOffset
Фиксированная дата и время истечения срока действия записи кэша. Этот параметр требуется при вызове Add метода.
- regionName
- String
Optional. Именованный регион в кэше, в который можно добавить запись кэша, если регионы реализованы. Так как регионы не реализованы в .NET Framework 4, значение по умолчанию — null.
Возвращаемое значение
true Значение , если вставка выполнена успешно, или false если в кэше уже есть запись, которая имеет тот же ключ, что keyи .
Комментарии
Add Перегрузки методов являются виртуальными (не абстрактными) для ObjectCache класса, так как Add метод внутренне вызываетAddOrGetExisting. Это уменьшает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует специального Add поведения для метода, она может просто реализовать AddOrGetExisting перегрузки метода.
Применяется к
Add(String, Object, CacheItemPolicy, String)
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
При переопределении в производном классе вставляет запись кэша в кэш, указывая сведения о том, как запись будет вытеснена.
public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As BooleanПараметры
- key
- String
Уникальный идентификатор записи кэша.
- value
- Object
Объект для вставки.
- policy
- CacheItemPolicy
Объект, содержащий сведения о вытеснения для записи кэша. Этот объект предоставляет больше возможностей для вытеснения, чем простой абсолютный срок действия.
- regionName
- String
Optional. Именованный регион в кэше, в который можно добавить запись кэша, если регионы реализованы. Значение по умолчанию для необязательного параметра null.
Возвращаемое значение
true Значение , если вставка выполнена успешно, или false если в кэше уже есть запись с тем же ключом, что keyи .
Комментарии
Add Перегрузки методов являются виртуальными (не абстрактными) для ObjectCache класса, так как Add метод внутренне вызываетAddOrGetExisting. Это уменьшает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует специального Add поведения для метода, она может просто реализовать AddOrGetExisting перегрузки метода.
