ObjectCache.AddOrGetExisting 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在派生类中重写时,尝试向缓存中插入缓存项,并返回具有匹配键的现有缓存项。
重载
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
- 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
- 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
- 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 对象。