ConverterCollectionsConverterCacheInsert Method (Object, Object, Int64) | 
Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02
 
            Associates the specified value with the specified key in this
            cache.
            
 
    Namespace: 
   Tangosol.Util
    Assembly:
   Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
Syntaxpublic virtual Object Insert(
	Object key,
	Object value,
	long millis
)
Parameters
- key
 - Type: SystemObject
            Key with which the specified value is to be associated.
             - value
 - Type: SystemObject
            Value to be associated with the specified key.
             - millis
 - Type: SystemInt64
            The number of milliseconds until the cache entry will expire,
            also referred to as the entry's "time to live"; pass
            DEFAULT to use the cache's
            default time-to-live setting; pass
            NEVER to indicate that the
            cache entry should never expire; this milliseconds value is
            not a date/time value, but the amount of time object
            will be kept in the cache.
             
Return Value
Type: 
Object
            Previous value associated with specified key, or 
null
            if there was no mapping for key. A 
null return can
            also indicate that the cache previously associated
            
null with the specified key, if the implementation
            supports 
null values.
            
Implements
ICacheInsert(Object, Object, Int64)
Exceptions| Exception | Condition | 
|---|
| NotSupportedException | 
            If the requested expiry is a positive value and the
            implementation does not support expiry of cache entries.
             | 
Remarks
            If the cache previously contained a mapping for this key, the
            old value is replaced.
            This variation of the 
Insert(Object, Object)
            method allows the caller to specify an expiry (or "time to
            live") for the cache entry.
            
See Also