ObjectCache.AddOrGetExisting Метод

Определение

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

System.Runtime.Caching

Сборка:

System.Runtime.Caching.dll

Пакет:

System.Runtime.Caching v11.0.0-preview.4.26230.115

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

Перегрузки

Имя	Описание
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

Optional. Именованный регион в кэше, в который можно добавить запись кэша, если регионы реализованы. Значение по умолчанию для необязательного параметра 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

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

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

Object

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

Комментарии

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