ObjectCache.Set 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在派生类中重写时,向缓存中插入缓存项。
重载
Set(CacheItem, CacheItemPolicy) |
在派生类中重写时,以 CacheItem 实例的形式向缓存中插入缓存项,同时指定有关如何逐出该项的信息。 |
Set(String, Object, DateTimeOffset, String) |
在派生类中重写时,向缓存中插入缓存项,同时指定基于时间的过期详细信息。 |
Set(String, Object, CacheItemPolicy, String) |
在派生类中重写时,向缓存中插入缓存项。 |
注解
重载方法的典型行为 Set 是插入或更新操作。 如果指定的项不存在,缓存项将作为新条目插入;如果缓存项已存在,则使用新值更新缓存项。
Set(CacheItem, CacheItemPolicy)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
在派生类中重写时,以 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)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
在派生类中重写时,向缓存中插入缓存项,同时指定基于时间的过期详细信息。
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)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
在派生类中重写时,向缓存中插入缓存项。
public abstract void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);
abstract member Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit
Public MustOverride Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)
参数
- key
- String
该缓存项的唯一标识符。
- value
- Object
要插入的对象。
- policy
- CacheItemPolicy
一个包含该缓存项的逐出详细信息的对象。 此对象提供比简单绝对过期更多的逐出选项。
- regionName
- String
可选。 缓存中的一个可用来添加缓存项的命名区域(如果实现了区域)。 可选参数的默认值为 null
。
注解
此方法重载允许提供比基于时间的绝对过期中可用的更多逐出或过期详细信息。
如果缓存中不存在与 匹配的 key
项, value
并且 key
用于作为新的缓存项进行插入。 如果存在键匹配 item
的项,则使用 value
更新或覆盖缓存条目。