ObjectCache.Set 方法

定义

命名空间:

System.Runtime.Caching

程序集:

System.Runtime.Caching.dll

包:

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

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

重载

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

注解

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

Set(CacheItem, CacheItemPolicy)

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

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

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

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

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更新或覆盖缓存条目。