IMap(TKey, TValue).PutAsync Method (TKey, TValue, Int64, TimeUnit)

IMapTKey, TValuePutAsync Method (TKey, TValue, Int64, TimeUnit)

Hazelcast .Net Client Class Library

Asynchronously puts the given key and value into this map with a given ttl (time to live) value.

Namespace: Hazelcast.Core
Assembly: Hazelcast.Net (in Hazelcast.Net.dll) Version: 3.8.1

Syntax

Task<TValue> PutAsync(
	TKey key,
	TValue value,
	long ttl,
	TimeUnit timeunit
)

Function PutAsync ( 
	key As TKey,
	value As TValue,
	ttl As Long,
	timeunit As TimeUnit
) As Task(Of TValue)

Task<TValue>^ PutAsync(
	TKey key, 
	TValue value, 
	long long ttl, 
	TimeUnit timeunit
)

abstract PutAsync : 
        key : 'TKey * 
        value : 'TValue * 
        ttl : int64 * 
        timeunit : TimeUnit -> Task<'TValue>

Parameters

key: Type: TKey
the key of the map entry
value: Type: TValue
the new value of the map entry
ttl: Type: SystemInt64
maximum time for this entry to stay in the map 0 means infinite.
timeunit: Type: Hazelcast.CoreTimeUnit
time unit for the ttl

Return Value

Type: TaskTValue
Task<V> from which the old value of the key can be retrieved.

Remarks

Asynchronously puts the given key and value into this map with a given ttl (time to live) value. Entry will expire and get evicted after the ttl. If ttl is 0, then the entry lives forever.

Copy

Task<V> task = map.PutAsync(key, value, ttl, timeunit);
// do some other stuff, when ready get the result
V oldValue = task.Result;

Task.Result will block until the actual map.Put() completes. If the application requires timely response, then task.Wait(timeout) can be used.

Copy

try
{
    Task<V> task = map.PutAsync(key, value, ttl, timeunit);
    if(task.Wait(TimeSpan.FromMilliseconds(40)))
    {
       V value = task.Result; 
    }
    else
    {
     //Result not ready
    }

Warning:

This method uses GetHashCode and Equals of binary form of the key, not the actual implementations of GetHashCode and Equals defined in key's class.

Reference

IMapTKey, TValue Interface

PutAsync Overload

Hazelcast.Core Namespace

System.Threading.TasksTaskTResult