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

IMapTKey, TValuePutAsync Method (TKey, TValue)

Hazelcast .Net Client Class Library

Asynchronously puts the given key and value.

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

Syntax

Task<TValue> PutAsync(
	TKey key,
	TValue value
)

Function PutAsync ( 
	key As TKey,
	value As TValue
) As Task(Of TValue)

Task<TValue>^ PutAsync(
	TKey key, 
	TValue value
)

abstract PutAsync : 
        key : 'TKey * 
        value : 'TValue -> Task<'TValue>

Parameters

key: Type: TKey
the key of the map entry
value: Type: TValue
the new value of the map entry

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.

Copy

Task<V> task = map.PutAsync(key, value);
// 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);
    if(task.Wait(TimeSpan.FromMilliseconds(40)))
    {
       V value = task.Result; 
    }
    else
    {
     //Result not ready
    }

ExecutionException is never thrown.

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