ObjectCache.Add Метод

Определение

Пространство имен:

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Пакет:

System.Runtime.Caching v9.0.0

При переопределении в производном классе вставляет запись в кэш без обязательного возврата существующей записи кэша с соответствующим ключом.

Перегрузки

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

При переопределении в производном классе пытается вставить запись в кэш как экземпляр 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 -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Параметры

item

CacheItem

Добавляемый объект.

policy

CacheItemPolicy

Объект, содержащий сведения о вытеснении для записи кэша. Этот объект предоставляет больше параметров для вытеснения, чем простой абсолютный срок действия.

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

Boolean

Значение true, если вставка выполнена успешно, или false, если в кэше уже имеется запись с таким же ключом, как у item

Комментарии

Перегрузки Add метода являются виртуальными (не абстрактными) в ObjectCache классе, так как Add метод внутренне вызывает AddOrGetExisting. Это сокращает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует какого-либо специального Add поведения для метода, она может просто реализовать перегрузки AddOrGetExisting метода.

Add(String, Object, DateTimeOffset, String)

Исходный код:

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 -> bool

Public 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значение .

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

Boolean

Значение true, если вставка выполнена успешно, или false, если в кэше уже имеется запись с таким же ключом, как у key

Комментарии

Перегрузки Add метода являются виртуальными (не абстрактными) в ObjectCache классе, так как Add метод внутренне вызывает AddOrGetExisting. Это сокращает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует какого-либо специального Add поведения для метода, она может просто реализовать перегрузки AddOrGetExisting метода.

Add(String, Object, CacheItemPolicy, String)

Исходный код:

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 -> bool

Public 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.

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

Boolean

Значение true, если вставка производится успешно, или false, если в кэше уже есть запись с таким же ключом, как у key.

Комментарии

Перегрузки Add метода являются виртуальными (не абстрактными) в ObjectCache классе, так как Add метод внутренне вызывает AddOrGetExisting. Это сокращает количество перегрузок методов, которые должен предоставить реализующий кэш. Если реализация кэша не требует какого-либо специального Add поведения для метода, она может просто реализовать перегрузки AddOrGetExisting метода.