DynamORM Documentation
This documentation is based on:
- XML comments in the library source (
DynamORM/*.cs,DynamORM/*/*.cs). - Executable usage patterns from the test suite (
DynamORM.Tests).
Contents
- Quick Start
- Dynamic Table API
- Fluent Builder API
- Typed Fluent Syntax
- Mapping and Entities
- Transactions and Disposal
- Stored Procedures
- ADO.NET Extensions
- .NET 4.0 Amalgamation
- Test-Driven Examples
Supported Targets
Main library targets are defined in DynamORM/DynamORM.csproj.
For legacy .NET 4.0 consumers, use the amalgamated source workflow documented in .NET 4.0 Amalgamation.
Design Overview
DynamORM provides two major usage styles:
- Dynamic table access:
db.Table("users").Count(...)db.Table("users").Insert(...)db.Table("users").Query(...)
- Fluent SQL builder access:
db.From<T>()db.Select<T>()db.Insert<T>() / db.Update<T>() / db.Delete<T>()
The dynamic API is concise and fast to use. The fluent builder API gives stronger composition and explicit SQL control.
For the newer property-mapped typed fluent syntax, see Typed Fluent Syntax.