Cache.Add Method (String, Object)

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Adds an object to the cache. Objects are not put in regions, and are distributed across all cache hosts in the cluster.

Namespace: System.Data.Caching
Assembly: ClientLibrary (in clientlibrary.dll)

Syntax

'Declaration
Public Function Add ( _
    key As String, _
    value As Object _
) As CacheItemVersion
'Usage
Dim instance As Cache
Dim key As String
Dim value As Object
Dim returnValue As CacheItemVersion

returnValue = instance.Add(key, value)

public CacheItemVersion Add (
    string key,
    Object value
)

public:
CacheItemVersion^ Add (
    String^ key, 
    Object^ value
)

public CacheItemVersion Add (
    String key, 
    Object value
)

public function Add (
    key : String, 
    value : Object
) : CacheItemVersion

Parameters

• key
  A unique value that is used to store and retrieve the object from cache.

• value
  The object saved to the cache cluster.

Return Value

A CacheItemVersion object that represents the version of the object saved to the cache under the key value.

Remarks

An exception is thrown if an item using the same key is already located in the cache. The object cached with this overload does not have any tags associated with it because it is not saved to a region. Expiration settings are derived from the named cache configuration. For more information, see Expiration and Eviction (Velocity). For more information about how to use this method, see How to: Add an Object to Cache (Velocity).

See Also

Reference

Cache Class
Cache Members
System.Data.Caching Namespace