ObjectCache.AddOrGetExisting Method (String, Object, CacheItemPolicy, 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, 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)

abstract AddOrGetExisting : 
        key:string *
        value:Object *
        policy:CacheItemPolicy *
        regionName:string = null -> Object

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: