ObjectCache.AddOrGetExisting Метод

Определение

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

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Пакет:

System.Runtime.Caching v9.0.0-rc.2.24473.5

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

Перегрузки

AddOrGetExisting(CacheItem, CacheItemPolicy)	При переопределении в производном классе вставляет заданный объект CacheItem в кэш и задает сведения о способе удаления записи.
AddOrGetExisting(String, Object, DateTimeOffset, String)	При переопределении в производном классе вставляет запись в кэш, используя ключ, объект для записи кэша, абсолютное значение срока действия и (необязательно) область кэша для добавления.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	При переопределении в производном классе вставляет запись в кэш, задавая ключ и значение для записи кэша и сведения о способе удаления этой записи.

Комментарии

Метод AddOrGetExisting перегружает вставку записи в кэш. Если запись кэша с совпадающим ключом уже существует, они возвращают существующую запись. Запись кэша CacheItem может быть объектом или универсальным объектом.

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

AddOrGetExisting(CacheItem, CacheItemPolicy)

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

ObjectCache.cs

При переопределении в производном классе вставляет заданный объект CacheItem в кэш и задает сведения о способе удаления записи.

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);

abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

Параметры

value

CacheItem

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

policy

CacheItemPolicy

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

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

CacheItem

Если существует запись кэша с таким же ключом, указанная запись кэша; в противном случае — значение null.

AddOrGetExisting(String, Object, DateTimeOffset, String)

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

ObjectCache.cs

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

public abstract object AddOrGetExisting (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public MustOverride Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object

Параметры

key

String

Уникальный идентификатор записи кэша.

value

Object

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

absoluteExpiration

DateTimeOffset

Фиксированные дата и время истечения срока действия записи кэша.

regionName

String

Необязательный элемент. Именованная область кэша, в которую может быть добавлена запись кэша, если области реализованы. Значение необязательного параметра по умолчанию — null.

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

Object

Заданное значение записи кэша, если существует запись кэша с таким же ключом; в противном случае — значение null.

Комментарии

Эта AddOrGetExisting(String, Object, DateTimeOffset, String) перегрузка метода возвращает значение объекта, а CacheItem не объект .

AddOrGetExisting(String, Object, CacheItemPolicy, String)

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

ObjectCache.cs

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

public abstract object AddOrGetExisting (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public MustOverride Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object

Параметры

key

String

Уникальный идентификатор записи кэша.

value

Object

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

policy

CacheItemPolicy

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

regionName

String

Необязательный элемент. Именованная область кэша, в которую может быть добавлена запись кэша, если области реализованы. Значение необязательного параметра по умолчанию — null.

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

Object

Заданное значение записи кэша, если существует запись кэша с таким же ключом; в противном случае — значение null.

Комментарии

Метод AddOrGetExisting(String, Object, CacheItemPolicy, String) возвращает значение объекта, а CacheItem не объект .