ObjectCache.AddOrGetExisting 方法

定义

命名空间:

System.Runtime.Caching

程序集:

System.Runtime.Caching.dll

包:

System.Runtime.Caching v9.0.0-rc.2.24473.5

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

重载

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

在派生类中重写时，向缓存中插入指定的 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)

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。

返回

Object

如果存在具有相同键的缓存项，则为指定缓存项的值；否则为 null。

注解

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

AddOrGetExisting(String, Object, CacheItemPolicy, String)

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。

返回

Object

如果存在具有相同键的缓存项，则为指定缓存项的值；否则为 null。

注解

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