Inserts or replaces an existing document into Couchbase Server as an asynchronous operation.
Namespace: CouchbaseAssembly: Couchbase.NetClient (in Couchbase.NetClient.dll) Version: 0.0.0.0 (0.0.0.0)
Syntaxpublic Task<IOperationResult<T>> UpsertAsync<T>(
string key,
T value,
ulong cas,
uint expiration
)
public Task<IOperationResult<T>> UpsertAsync<T>(
string key,
T value,
ulong cas,
uint expiration
)
Public Function UpsertAsync(Of T) (
key As String,
value As T,
cas As ULong,
expiration As UInteger
) As Task(Of IOperationResult(Of T))
Public Function UpsertAsync(Of T) (
key As String,
value As T,
cas As ULong,
expiration As UInteger
) As Task(Of IOperationResult(Of T))
public:
generic<typename T>
virtual Task<IOperationResult<T>^>^ UpsertAsync(
String^ key,
T value,
unsigned long long cas,
unsigned int expiration
) sealed
public:
generic<typename T>
virtual Task<IOperationResult<T>^>^ UpsertAsync(
String^ key,
T value,
unsigned long long cas,
unsigned int expiration
) sealed
abstract UpsertAsync :
key : string *
value : 'T *
cas : uint64 *
expiration : uint32 -> Task<IOperationResult<'T>>
override UpsertAsync :
key : string *
value : 'T *
cas : uint64 *
expiration : uint32 -> Task<IOperationResult<'T>> abstract UpsertAsync :
key : string *
value : 'T *
cas : uint64 *
expiration : uint32 -> Task<IOperationResult<'T>>
override UpsertAsync :
key : string *
value : 'T *
cas : uint64 *
expiration : uint32 -> Task<IOperationResult<'T>> Parameters
- key
- Type: System.String
The unique key for indexing.
- value
- Type: T
The value for the key.
- cas
- Type: System.UInt64
The CAS (Check and Set) value for optimistic concurrency.
- expiration
- Type: System.UInt32
The time-to-live (ttl) for the key in seconds.
Type Parameters - T
- The Type of the value to be inserted.
Return Value
Type:
Task<IOperationResult<T>>
The
Task<TResult> object representing the asynchronous operation.
Implements
IBucket.UpsertAsync<T>(String, T, UInt64, UInt32)Remarks
Expirations over 30 * 24 * 60 * 60 (the amount of seconds in 30 days) are interpreted as a UNIX timestamp of the date at which the document expires.
see
documentation section about expiration.
See Also