ObjectCache.Add 方法

定义

命名空间:

System.Runtime.Caching

程序集:

System.Runtime.Caching.dll

包:

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

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

重载

Add(CacheItem, CacheItemPolicy)	在派生类中重写时，尝试以 CacheItem 实例的形式将缓存项插入缓存中，并添加有关应如何逐出该项的详细信息。
Add(String, Object, DateTimeOffset, String)	在派生类中重写时，向缓存中插入缓存项，而不会覆盖任何现有的缓存项。
Add(String, Object, CacheItemPolicy, String)	在派生类中重写时，向缓存中插入缓存项，同时指定有关如何逐出该项的信息。

注解

方法 Add 重载尝试在缓存中插入缓存条目，而不会覆盖或删除具有相同键的现有缓存条目。 缓存项可以是类型化 CacheItem 对象或泛型对象。

方法 AddOrGetExisting 重载和 Add 方法重载有一个显著差异。 当这些方法插入缓存条目时，如果在缓存中找到匹配的条目，则 AddOrGetExisting 方法重载将返回现有缓存项，但 Add 方法重载不会。 有了这些不同的方法重载，调用方就可以根据是否需要现有缓存条目来优化代码。 在分布式缓存中，使用 AddOrGetExisting 方法返回现有值可能比使用 Add 方法返回布尔值更昂贵。

Add(CacheItem, CacheItemPolicy)

Source:

ObjectCache.cs

在派生类中重写时，尝试以 CacheItem 实例的形式将缓存项插入缓存中，并添加有关应如何逐出该项的详细信息。

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

参数

item

CacheItem

要添加的对象。

policy

CacheItemPolicy

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

返回

Boolean

如果插入成功，则为 true；如果缓存中已存在具有与 item 相同的键的项，则为 false。

注解

方法 Add 重载是虚拟 (类上 ObjectCache 不是抽象) ，因为 Add 该方法在内部调用 AddOrGetExisting。 这可以减少缓存实现者必须提供的方法重载数。 如果缓存实现不需要方法的任何特殊行为 Add ，则它只能实现 AddOrGetExisting 方法重载。

Add(String, Object, DateTimeOffset, String)

Source:

ObjectCache.cs

在派生类中重写时，向缓存中插入缓存项，而不会覆盖任何现有的缓存项。

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool

Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

参数

key

String

该缓存项的唯一标识符。

value

Object

要插入的对象。

absoluteExpiration

DateTimeOffset

缓存项的固定的过期日期和时间。 调用 Add 方法时，此参数是必需的。

regionName

String

可选。 缓存中的一个可用来添加缓存项的命名区域（如果实现了区域）。 由于区域未在 .NET Framework 4 中实现，因此默认值为 null。

返回

Boolean

如果插入成功，则为 true；如果缓存中已存在具有与 key 相同的键的项，则为 false。

注解

方法 Add 重载是虚拟 (类上 ObjectCache 不是抽象) ，因为 Add 该方法在内部调用 AddOrGetExisting。 这可以减少缓存实现者必须提供的方法重载数。 如果缓存实现不需要方法的任何特殊行为 Add ，则它只能实现 AddOrGetExisting 方法重载。

Add(String, Object, CacheItemPolicy, String)

Source:

ObjectCache.cs

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

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool

Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

参数

key

String

该缓存项的唯一标识符。

value

Object

要插入的对象。

policy

CacheItemPolicy

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

regionName

String

可选。 缓存中的一个可用来添加缓存项的命名区域（如果实现了区域）。 可选参数的默认值为 null。

返回

Boolean

如果尝试插入成功，则为 true；如果缓存中已存在具有与 key 相同的键的项，则为 false。

注解

方法 Add 重载是虚拟 (类上 ObjectCache 不是抽象) ，因为 Add 该方法在内部调用 AddOrGetExisting。 这可以减少缓存实现者必须提供的方法重载数。 如果缓存实现不需要方法的任何特殊行为 Add ，则它只能实现 AddOrGetExisting 方法重载。