This documentation is archived and is not being maintained.

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

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
) 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 nullptr.

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

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.
Show: