ObjectCache::AddOrGetExisting Method (String^, Object^, DateTimeOffset, String^)

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

When overridden in a derived class, inserts a cache entry into the cache, by using a key, an object for the cache entry, an absolute expiration value, and an optional region to add the cache into.

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

public:
virtual Object^ AddOrGetExisting(
	String^ key,
	Object^ value,
	DateTimeOffset absoluteExpiration,
	String^ regionName = null
) abstract

Parameters

key
Type: System::String^

A unique identifier for the cache entry.

value
Type: System::Object^

The object to insert.

absoluteExpiration
Type: System::DateTimeOffset

The fixed date and time at which the cache entry will expire.

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.

This AddOrGetExisting(String^, Object^, DateTimeOffset, String^) method overload returns an object value, not a CacheItem object.

.NET Framework
Available since 4.0
Return to top
Show: