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:
virtual Object^ AddOrGetExisting(
	String^ key,
	Object^ value,
	CacheItemPolicy^ policy,
	String^ regionName = null
) abstract

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: