Class WriteBatch (2.5.0)

public sealed class WriteBatch

A batch of write operations, to be applied in a single commit.

Inheritance

Object > WriteBatch

Google.Cloud.Firestore.dll

public Task<IList<WriteResult>> CommitAsync(CancellationToken cancellationToken = default(CancellationToken))

Commits the batch on the server.

Parameter
Name	Description
`cancellationToken`	`CancellationToken`

Returns
Type	Description
`Task<IList<WriteResult>>`	The write results from the commit.

public WriteBatch Create(DocumentReference documentReference, object documentData)

Adds a write operation which will create the specified document with a precondition that it doesn't exist already.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to create. Must not be null.
`documentData`	`Object` The data for the document. Must not be null.

Returns
Type	Description
`WriteBatch`	This batch, for the purpose of method chaining

public WriteBatch Delete(DocumentReference documentReference, Precondition precondition = null)

Adds a write operation that deletes the specified document, with an optional precondition.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to delete. Must not be null.
`precondition`	`Precondition` Optional precondition for deletion. May be null, in which case the deletion is unconditional.

Returns
Type	Description
`WriteBatch`	This batch, for the purposes of method chaining.

public WriteBatch Set(DocumentReference documentReference, object documentData, SetOptions options = null)

Adds an operation that sets data in a document, either replacing it completely or merging fields.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to update. Must not be null.
`documentData`	`Object` The data to store in the document. Must not be null.
`options`	`SetOptions` The options to use when setting data in the document. May be null, which is equivalent to Overwrite.

Returns
Type	Description
`WriteBatch`	This batch, for the purposes of method chaining.

public WriteBatch Update(DocumentReference documentReference, IDictionary<FieldPath, object> updates, Precondition precondition = null)

Adds an update operation that updates just the specified fields paths in the document, with the corresponding values.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to update. Must not be null.
`updates`	`IDictionary<FieldPath, Object>` The updates to perform on the document, keyed by the field path to update. Fields not present in this dictionary are not updated. Must not be null or empty.
`precondition`	`Precondition` Optional precondition for updating the document. May be null, which is equivalent to MustExist.

Returns
Type	Description
`WriteBatch`	This batch, for the purposes of method chaining.

public WriteBatch Update(DocumentReference documentReference, IDictionary<string, object> updates, Precondition precondition = null)

Adds an update operation that updates just the specified fields paths in the document, with the corresponding values.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to update. Must not be null.
`updates`	`IDictionary<String, Object>` The updates to perform on the document, keyed by the dot-separated field path to update. Fields not present in this dictionary are not updated. Must not be null or empty.
`precondition`	`Precondition` Optional precondition for updating the document. May be null, which is equivalent to MustExist.

Returns
Type	Description
`WriteBatch`	This batch, for the purposes of method chaining.

public WriteBatch Update(DocumentReference documentReference, string field, object value, Precondition precondition = null)

Adds an update operation that updates just the specified field in the document, with the corresponding values.

Parameters
Name	Description
`documentReference`	`DocumentReference` A document reference indicating the path of the document to update. Must not be null.
`field`	`String` The dot-separated name of the field to update. Must not be null.
`value`	`Object` The new value for the field. May be null.
`precondition`	`Precondition` Optional precondition for updating the document. May be null, which is equivalent to MustExist.

Returns
Type	Description
`WriteBatch`	This batch, for the purposes of method chaining.