How mongodb/mongo-csharp-driver works
The repository is the official MongoDB .NET/C# driver. Its documented user workflow creates a client, selects a database and collection, writes typed or untyped documents, then queries and materializes results. The map also preserves the BSON model/serialization layer, aggregation and LINQ translation, and optional AWS authentication and client-side encryption. Several driver internals are unsampled, so those subsystems are represented at their existing source directories; only documented or excerpt-supported relationships are drawn.
Main entry points: IMongoCollection.cs Collection API · AstPipeline.cs Pipeline AST · MongoDB.Driver MongoClient · ExpressionToPipelineTranslators Expression Translators
Components 23
Driver API
- MongoClient
src/MongoDB.Driver - Database API
src/MongoDB.Driver - Collection API
src/MongoDB.Driver/IMongoCollection.cs
BSON Data
- BSON Values
src/MongoDB.Bson/ObjectModel/BsonValue.cs - BSON Documents
src/MongoDB.Bson/ObjectModel/BsonDocument.cs - BSON Arrays
src/MongoDB.Bson/ObjectModel/BsonArray.cs - Serializer Facade
src/MongoDB.Bson/Serialization/BsonSerializer.cs - Deserialization Context
src/MongoDB.Bson/Serialization/BsonDeserializationContext.cs - Serializer Implementations
src/MongoDB.Bson/Serialization/Serializers - BSON Binary I/O
src/MongoDB.Bson/IO
Query Construction
- Filter Definitions
src/MongoDB.Driver/FilterDefinition.cs - Pipeline API
src/MongoDB.Driver/PipelineDefinition.cs - Stage Builder
src/MongoDB.Driver/PipelineStageDefinitionBuilder.cs - LINQ Provider
src/MongoDB.Driver/Linq/Linq3Implementation/MongoQueryProvider.cs - Expression Translators
src/MongoDB.Driver/Linq/Linq3Implementation/Translators/ExpressionToPipelineTranslators - Pipeline AST
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/AstPipeline.cs - AST Stages
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/Stages/AstStage.cs - Pipeline Optimizer
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/Optimizers/AstGroupingPipelineOptimizer.cs
Optional Integrations
- AWS Authentication
src/MongoDB.Driver.Authentication.AWS - Client Encryption
src/MongoDB.Driver.Encryption/ClientEncryption.cs - Crypt Controller
src/MongoDB.Driver.Encryption/LibMongoCryptControllerBase.cs
Other components
- Application
- MongoDB Server
Connections 16
- Application → MongoClient: creates
- MongoClient → Database API: selects
- Database API → Collection API: selects
src/MongoDB.Driver/PipelineStageDefinitionBuilder.cs - Collection API → MongoDB Server: writes documents
- Collection API → MongoDB Server: queries documents
- Application → Collection API: supplies typed data
- Serializer Facade → Deserialization Context: configures context
src/MongoDB.Bson/Serialization/BsonSerializer.cs - Serializer Implementations → Deserialization Context: deserializes through
- Pipeline AST → AST Stages: holds stages
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/AstPipeline.cs - Pipeline AST → BSON Arrays: renders as
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/AstPipeline.cs - Stage Builder → Pipeline API: builds stages for
src/MongoDB.Driver/PipelineStageDefinitionBuilder.cs - LINQ Provider → Expression Translators: translates expressions
src/MongoDB.Driver/Linq/Linq3Implementation/Translators/ExpressionToPipelineTranslators/LookupMethodToPipelineTranslator.cs - Expression Translators → Pipeline AST: constructs pipeline
src/MongoDB.Driver/Linq/Linq3Implementation/Translators/ExpressionToPipelineTranslators/LookupMethodToPipelineTranslator.cs - Pipeline Optimizer → Pipeline AST: optimizes pipeline
src/MongoDB.Driver/Linq/Linq3Implementation/Ast/Optimizers/AstGroupingPipelineOptimizer.cs - AWS Authentication → MongoClient: extends authentication
src/MongoDB.Driver.Authentication.AWS/ExtensionManagerExtensions.cs - Client Encryption → Crypt Controller: uses controller
src/MongoDB.Driver.Encryption/LibMongoCryptControllerBase.cs