AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Class for putting and/or deleting a batch of items in a single DynamoDB table.

Inheritance Hierarchy


Namespace: Amazon.DynamoDBv2.DocumentModel
Assembly: AWSSDK.DynamoDBv2.dll
Version: 3.x.y.z


public class DocumentBatchWrite

The DocumentBatchWrite type exposes the following members


Public Method DocumentBatchWrite(Table)

Constructs a DocumentBatchWrite instance for a specific table.



Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

Public Method AddDocumentToPut(Document)

Add a single Document to put.

Public Method AddItemToDelete(Document)

Add a single item to delete, identified by a Document object.

Public Method AddKeyToDelete(Primitive)

Add a single item to delete, identified by its hash primary key.

Public Method AddKeyToDelete(Primitive, Primitive)

Add a single item to delete, identified by its hash-and-range primary key.

Public Method AddKeyToDelete(IDictionary<String, DynamoDBEntry>)

Add a single item to delete, identified by its key.

Public Method Combine(DocumentBatchWrite)

Creates a MultiTableDocumentBatchWrite object that is a combination of the current DocumentBatchWrite and the specified DocumentBatchWrite.

Public Method Execute()

Executes a server call to batch-put/delete the item specified. If more than 25 put/delete operations are specified, calls of up to 25 put/delete items will be made until all items are processed.

Public Method ExecuteAsync(CancellationToken)

Initiates the asynchronous execution of the Execute operation. Amazon.DynamoDBv2.DocumentModel.DocumentBatchWrite.Execute

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone