AddOrGetExisting Method (String, Object, CacheItemPolicy, String)

ObjectCache.AddOrGetExisting Method (String, Object, CacheItemPolicy, String)

.NET Framework (current version)
 

When overridden in a derived class, inserts a cache entry into the cache, specifying a key and a value for the cache entry, and information about how the entry will be evicted.

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

public abstract object AddOrGetExisting(
	string key,
	object value,
	CacheItemPolicy policy,
	string regionName = null
)

Parameters

key
Type: System.String

A unique identifier for the cache entry.

value
Type: System.Object

The object to insert.

policy
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.

regionName
Type: System.String

Optional. A named region in the cache to which the cache entry can be added, if regions are implemented. The default value for the optional parameter is null.

Return Value

Type: System.Object

If a cache entry with the same key exists, the specified cache entry's value; otherwise, null.

The AddOrGetExisting(String, Object, CacheItemPolicy, String) method returns an object value, not a CacheItem object.

.NET Framework
Available since 4.0
Return to top
Show:
© 2016 Microsoft