This documentation is archived and is not being maintained.

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

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


Type: System.String
A unique identifier for the cache entry.
Type: System.Object
The object to insert.
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.
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

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.