ObjectCache.Add 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在派生类中重写时，将缓存条目插入缓存，而无需返回具有匹配键的现有缓存项。
重载
| 名称 | 说明 |
|---|---|
| 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
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean参数
- item
- CacheItem
要添加的对象。
- policy
- CacheItemPolicy
一个对象，其中包含缓存项的逐出详细信息。 此对象提供的逐出选项比简单的绝对到期时间更多。
返回
true 如果插入成功，或者 false 缓存中已有与 具有相同键的条目，则为 item。
注解
方法 Add 重载是类上的 ObjectCache 虚拟（非抽象），因为 Add 该方法在内部调用 AddOrGetExisting。 这减少了缓存实现程序必须提供的方法重载数。 如果缓存实现不需要该方法的任何特殊行为 Add ，则只需实现 AddOrGetExisting 方法重载。
适用于
Add(String, Object, DateTimeOffset, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic 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
Optional. 如果实现了区域，可以在缓存中添加缓存条目的命名区域。 由于区域未在 .NET Framework 4 中实现，因此默认值为 null。
返回
true 如果插入成功，或者 false 缓存中已有与 具有相同键的条目，则为 key。
注解
方法 Add 重载是类上的 ObjectCache 虚拟（非抽象），因为 Add 该方法在内部调用 AddOrGetExisting。 这减少了缓存实现程序必须提供的方法重载数。 如果缓存实现不需要该方法的任何特殊行为 Add ，则只需实现 AddOrGetExisting 方法重载。
适用于
Add(String, Object, CacheItemPolicy, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
- 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 -> boolPublic 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
Optional. 如果实现了区域，可以在缓存中添加缓存条目的命名区域。 可选参数的默认值为 null。
返回
true 如果插入尝试成功，或者 false 缓存中已有一个项，则为 。如果插入成功，则为 key。
注解
方法 Add 重载是类上的 ObjectCache 虚拟（非抽象），因为 Add 该方法在内部调用 AddOrGetExisting。 这减少了缓存实现程序必须提供的方法重载数。 如果缓存实现不需要该方法的任何特殊行为 Add ，则只需实现 AddOrGetExisting 方法重载。
