ObjectCache.AddOrGetExisting 方法

定义

在派生类中重写时,尝试向缓存中插入缓存项,并返回具有匹配键的现有缓存项。

重载

AddOrGetExisting(CacheItem, CacheItemPolicy)

在派生类中重写时,向缓存中插入指定的 CacheItem 对象,同时指定有关如何逐出该项的信息。

AddOrGetExisting(String, Object, DateTimeOffset, String)

在派生类中重写时,通过使用键、表示缓存项的对象、绝对过期值和要添加缓存的可选区域,向缓存中插入缓存项。

AddOrGetExisting(String, Object, CacheItemPolicy, String)

在派生类中重写时,向缓存中插入缓存项,并指定该缓存项的键和值以及有关如何逐出该项的信息。

注解

方法 AddOrGetExisting 重载将条目插入缓存中。 如果已存在具有匹配键的缓存项,则返回现有条目。 缓存项可以是 CacheItem 对象,也可以是泛型对象。

重载和Add重载之间AddOrGetExisting有一个区别。 当这些重载的方法尝试插入缓存项时,如果发现现有条目具有与现有插入的缓存项匹配的键,则 AddOrGetExisting 重载将返回现有缓存项。 重 Add 载不会。

AddOrGetExisting(CacheItem, CacheItemPolicy)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
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

一个包含该缓存项的逐出详细信息的对象。 此对象提供比简单绝对过期更多的逐出选项。

返回

如果存在具有相同键的缓存项,则为指定的缓存项;否则为 null

适用于

AddOrGetExisting(String, Object, DateTimeOffset, String)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
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

返回

如果存在具有相同键的缓存项,则为指定缓存项的值;否则为 null

注解

此方法 AddOrGetExisting(String, Object, DateTimeOffset, String) 重载返回对象值,而不是 CacheItem 对象。

适用于

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Source:
ObjectCache.cs
Source:
ObjectCache.cs
Source:
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

返回

如果存在具有相同键的缓存项,则为指定缓存项的值;否则为 null

注解

方法 AddOrGetExisting(String, Object, CacheItemPolicy, String) 返回对象值,而不是 CacheItem 对象。

适用于