ObjectCache.Add Method (CacheItem, CacheItemPolicy)

.NET Framework (current version)

When overridden in a derived class, tries to insert a cache entry into the cache as a CacheItem instance, and adds details about how the entry should be evicted.

Namespace:   System.Runtime.Caching
Assembly:  System.Runtime.Caching (in System.Runtime.Caching.dll)

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


Type: System.Runtime.Caching.CacheItem

The object to add.

Type: System.Runtime.Caching.CacheItemPolicy

An object that contains eviction details for the cache entry. This object provides more options for eviction than a simple absolute expiration.

Return Value

Type: System.Boolean

true if insertion succeeded, or false if there is an already an entry in the cache that has the same key as item.

The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. This reduces the number of method overloads that a cache implementer has to provide. If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

.NET Framework
Available since 4.0
Return to top