ObjectCache.AddOrGetExisting Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе пытается вставить запись в кэш и возвращает существующую запись кэша с соответствующим ключом.
Перегрузки
| 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
- Исходный код:
- 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.CacheItemPublic MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItemПараметры
- value
- CacheItem
Вставляемый объект.
- policy
- CacheItemPolicy
Объект, содержащий сведения о вытеснении для записи кэша. Этот объект предоставляет больше параметров для вытеснения, чем простой абсолютный срок действия.
Возвращаемое значение
Если существует запись кэша с таким же ключом, указанная запись кэша; в противном случае — значение null.
Применяется к
AddOrGetExisting(String, Object, DateTimeOffset, String)
- Исходный код:
- ObjectCache.cs
- Исходный код:
- ObjectCache.cs
При переопределении в производном классе вставляет запись в кэш, используя ключ, объект для записи кэша, абсолютное значение срока действия и (необязательно) область кэша для добавления.
public abstract object AddOrGetExisting (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> objPublic 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.
Возвращаемое значение
Заданное значение записи кэша, если существует запись кэша с таким же ключом; в противном случае — значение null.
Комментарии
Эта AddOrGetExisting(String, Object, DateTimeOffset, String) перегрузка метода возвращает значение объекта, а CacheItem не объект .
Применяется к
AddOrGetExisting(String, Object, CacheItemPolicy, String)
- Исходный код:
- ObjectCache.cs
- Исходный код:
- 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 -> objPublic 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.
Возвращаемое значение
Заданное значение записи кэша, если существует запись кэша с таким же ключом; в противном случае — значение null.
Комментарии
Метод AddOrGetExisting(String, Object, CacheItemPolicy, String) возвращает значение объекта, а CacheItem не объект .
