ObjectCache::Set Method (String^, Object^, CacheItemPolicy^, String^)

.NET Framework (current version)
 

When overridden in a derived class, inserts a cache entry into the cache.

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

public:
virtual void Set(
	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.

This method overload lets you provide more eviction or expiration details than those that are available in time-based absolute expiration.

If an item that matches key does not exist in the cache, value and key are used to insert as a new cache entry. If an item with a key that matches item exists, the cache entry is updated or overwritten by using value.

.NET Framework
Available since 4.0
Return to top
Show: