Method PutIfVersionAsync
PutIfVersionAsync(String, MapValue, RowVersion, PutOptions, CancellationToken)
Puts a row into a table if there is an existing row that matches
the primary key and its RowVersion matches the
provided value.
Declaration
public Task<PutResult<RecordValue>> PutIfVersionAsync(string tableName, MapValue row, RowVersion version, PutOptions options = null, CancellationToken cancellationToken = null)Parameters
| Type | Name | Description |
|---|---|---|
| String | tableName | Name of the table. |
| MapValue | row | Table row. |
| RowVersion | version | Row version to match. |
| PutOptions | options | (Optional) Options for the Put operation. Note that the values of IfAbsent, IfPresent and MatchVersion are not used for this API. |
| CancellationToken | cancellationToken | (Optional) Cancellation token. |
Returns
| Type | Description |
|---|---|
| Task<PutResult<RecordValue>> | Task returning PutResult<TRow>. |
Remarks
This API is a shorthand for PutAsync(String, MapValue, PutOptions, CancellationToken) with
MatchVersion specified.
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If
tableName is null or invalid or
row is null or invalid or
version is null or invalid or
or options contains invalid values. |
| TimeoutException | Operation has timed out. |
| InvalidOperationException | The table or the service is not in a valid state to perform this operation. |
| NoSQLException | NoSQLException or one of its subclasses is thrown if operation cannot be performed for any other reason. See documentation for corresponding subclass of NoSQLException. |