Click or drag to resize

IMongoCollectionExtensions.FindOneAndReplaceAsync<TDocument> Method (IMongoCollection<TDocument>, IClientSessionHandle, FilterDefinition<TDocument>, TDocument, FindOneAndReplaceOptions<TDocument, TDocument>, CancellationToken)

Finds a single document and replaces it atomically.

Namespace:  MongoDB.Driver
Assembly:  MongoDB.Driver (in MongoDB.Driver.dll) Version: 2.20.0+ee01960089f28ea1b501690df5fc9f6318a70242
Syntax
public static Task<TDocument> FindOneAndReplaceAsync<TDocument>(
	this IMongoCollection<TDocument> collection,
	IClientSessionHandle session,
	FilterDefinition<TDocument> filter,
	TDocument replacement,
	FindOneAndReplaceOptions<TDocument, TDocument> options = null,
	CancellationToken cancellationToken = null
)

Parameters

collection
Type: MongoDB.Driver.IMongoCollection<TDocument>
The collection.
session
Type: MongoDB.Driver.IClientSessionHandle
The session.
filter
Type: MongoDB.Driver.FilterDefinition<TDocument>
The filter.
replacement
Type: TDocument
The replacement.
options (Optional)
Type: MongoDB.Driver.FindOneAndReplaceOptions<TDocument, TDocument>
The options.
cancellationToken (Optional)
Type: System.Threading.CancellationToken
The cancellation token.

Type Parameters

TDocument
The type of the document.

Return Value

Type: Task<TDocument>
The returned document.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IMongoCollection<TDocument>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
See Also