ObjectCache.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе вставляет запись в кэш без обязательного возврата существующей записи кэша с соответствующим ключом.
Перегрузки
| Add(CacheItem, CacheItemPolicy) |
При переопределении в производном классе пытается вставить запись в кэш как экземпляр CacheItem и добавляет сведения о том, как следует удалить эту запись. |
| Add(String, Object, DateTimeOffset, String) |
При переопределении в производном классе используется для вставки записи в кэш, без перезаписи существующей в кэше записи. |
| Add(String, Object, CacheItemPolicy, String) |
При переопределении в производном классе вставляет запись в кэш и задает сведения о способе удаления записи. |
Комментарии
Перегрузки Add метода пытаются вставить запись кэша в кэш без перезаписи или удаления существующей записи кэша с тем же ключом. Запись кэша может быть типизированным CacheItem объектом или универсальным объектом.
Перегрузки AddOrGetExisting метода и перегрузки Add метода имеют одно существенное различие. Когда эти методы вставляют запись кэша, если в кэше найдена соответствующая запись, AddOrGetExisting перегрузки метода возвращают существующую запись кэша Add , а перегрузки метода — нет. Наличие этих различных перегрузок методов позволяет вызывающим абонентам оптимизировать свой код в зависимости от того, требуется ли им существующая запись кэша. В распределенных кэшах возврат существующего значения с помощью AddOrGetExisting метода может оказаться дороже, чем возврат логического значения с помощью Add метода .
- Исходный код:
- 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 метода.
Применяется к
.NET 10 (package-provided) и другие версии
| Продукт | Версии |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
- Исходный код:
- 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
Необязательный элемент. Именованная область кэша, в которую может быть добавлена запись кэша, если области реализованы. Так как регионы не реализованы в платформа .NET Framework 4, по умолчанию используется nullзначение .
Возвращаемое значение
Значение true, если вставка выполнена успешно, или false, если в кэше уже имеется запись с таким же ключом, как у key
Комментарии
Перегрузки Add метода являются виртуальными (не абстрактными) в ObjectCache классе, так как Add метод внутренне вызывает AddOrGetExisting. Это сокращает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует какого-либо специального Add поведения для метода, она может просто реализовать перегрузки AddOrGetExisting метода.
Применяется к
.NET 10 (package-provided) и другие версии
| Продукт | Версии |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
- Исходный код:
- 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
Необязательный элемент. Именованная область кэша, в которую может быть добавлена запись кэша, если области реализованы. Значение необязательного параметра по умолчанию — null.
Возвращаемое значение
Значение true, если вставка производится успешно, или false, если в кэше уже есть запись с таким же ключом, как у key.
Комментарии
Перегрузки Add метода являются виртуальными (не абстрактными) в ObjectCache классе, так как Add метод внутренне вызывает AddOrGetExisting. Это сокращает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует какого-либо специального Add поведения для метода, она может просто реализовать перегрузки AddOrGetExisting метода.
Применяется к
.NET 10 (package-provided) и другие версии
| Продукт | Версии |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
