ArxMongoConnection class · MongoDB in C#

Definition

Namespace: ARX.SDK.MongoDb.Services
Package: ARX.SDK.MongoDb

public sealed class ArxMongoConnection : ArxConnection

A MongoDB connection for ARX transactions. Application code begins a transaction on it and passes the transaction to ArxMongoDbService calls; it never needs a driver type.

Constructor

ArxMongoConnection(ArxMongoDbService service)
A connection on the service's client and database.
Parameter Type Description
service ArxMongoDbService The service whose calls will take the transaction.
ArxMongoConnection(string connectionString)
A connection for the database a connection string names (a service is made for it).
Parameter Type Description
connectionString string A MongoDB connection string naming the database.

Parameter	Type	Description
`service`	`ArxMongoDbService`	The service whose calls will take the transaction.

Parameter	Type	Description
`connectionString`	`string`	A MongoDB connection string naming the database.

Usage

A line from a verified sample; the full, runnable code is on its page.

await using var connection = new ArxMongoConnection(service);

Create in an ARX transaction, scenario 1

Used in:

Create in an ARX transactionCreate
Replace a record in a transactionDelete
Read your writes in a transactionRetrieveMultiple

Notes

It holds a driver session on the service's client. Transactions need a replica set or a sharded cluster: on a standalone server BeginTransactionAsync is ARX8001. A transaction reads a snapshot and commits with write concern majority. MongoDB has no savepoints, and a failed call aborts the whole transaction on the server, so a failure makes it IsAborted (later calls are ARX1015). One transaction at a time, one call at a time; not thread-safe. MongoDB ends a transaction that stays open longer than transactionLifetimeLimitSeconds (60 s by default).