ObjectCache.AddOrGetExisting Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе пытается вставить запись в кэш и возвращает существующую запись кэша с соответствующим ключом.
Перегрузки
| AddOrGetExisting(CacheItem, CacheItemPolicy) |
При переопределении в производном классе вставляет заданный объект CacheItem в кэш и задает сведения о способе удаления записи. |
| AddOrGetExisting(String, Object, DateTimeOffset, String) |
При переопределении в производном классе вставляет запись в кэш, используя ключ, объект для записи кэша, абсолютное значение срока действия и (необязательно) область кэша для добавления. |
| AddOrGetExisting(String, Object, CacheItemPolicy, String) |
При переопределении в производном классе вставляет запись в кэш, задавая ключ и значение для записи кэша и сведения о способе удаления этой записи. |
Комментарии
Метод AddOrGetExisting перегружает вставку записи в кэш. Если запись кэша с совпадающим ключом уже существует, они возвращают существующую запись. Запись кэша CacheItem может быть объектом или универсальным объектом.
Существует одно различие между AddOrGetExisting перегрузками и Add перегрузками. Если эти перегруженные методы пытаются вставить запись кэша, при обнаружении существующей записи с ключом, соответствующим существующей записи вставленного кэша, AddOrGetExisting перегрузки возвращают существующую запись кэша. Перегрузки Add не выполняются.
- Исходный код:
- ObjectCache.cs
- Исходный код:
- 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.
Применяется к
.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 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 не объект .
Применяется к
.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 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 не объект .
Применяется к
.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) |
