ObjectCache.Set 方法

参考

定义

命名空间:: System.Runtime.Caching

程序集:: System.Runtime.Caching.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在派生类中重写时，向缓存中插入缓存项。

重载

Set(CacheItem, CacheItemPolicy)	在派生类中重写时，以 CacheItem 实例的形式向缓存中插入缓存项，同时指定有关如何逐出该项的信息。
Set(String, Object, DateTimeOffset, String)	在派生类中重写时，向缓存中插入缓存项，同时指定基于时间的过期详细信息。
Set(String, Object, CacheItemPolicy, String)	在派生类中重写时，向缓存中插入缓存项。

注解

重载方法的典型行为 Set 是插入或更新操作。如果指定的条目不存在，缓存项将插入为新条目，或者缓存项已存在时会使用新值进行更新。

Set(CacheItem, CacheItemPolicy)

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

public:
 abstract void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract void Set (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public MustOverride Sub Set (item As CacheItem, policy As CacheItemPolicy)

参数

item: CacheItem

要添加的缓存项。

policy: CacheItemPolicy

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

注解

如果不存在密钥 item ， item 则插入为新的缓存条目。如果具有匹配 item 项的项存在，则该值 item 用于更新或覆盖现有缓存项的值。

适用于

Set(String, Object, DateTimeOffset, String)

在派生类中重写时，向缓存中插入缓存项，同时指定基于时间的过期详细信息。

public abstract void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Set : string * obj * DateTimeOffset * string -> unit

Public MustOverride Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

参数

key: String

该缓存项的唯一标识符。

value: Object

要插入的对象。

absoluteExpiration: DateTimeOffset

缓存项的固定的过期日期和时间。

regionName: String

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

注解

如果缓存中不存在匹配 key 项， value 并且 key 用于作为新缓存项插入。如果具有匹配 item 项的项存在，则使用 value 更新或覆盖缓存项。

适用于

Set(String, Object, CacheItemPolicy, String)