Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ dotnet add package Microsoft.Data.Sqlite
| `Open.Database.Extensions.SqlClient` | The same API on the older `System.Data.SqlClient`. Deprecated: use `MSSqlClient`. |
| `Open.Database.Extensions` | Discontinued. It only referenced Core: use `Open.Database.Extensions.Core`. The last published version is 9.0.3. |

Targets: `netstandard2.0`, `netstandard2.1` and `net10.0` (`MSSqlClient`: `net472` and `net10.0`). Version 11 is a release candidate (`11.0.0-rc.1`): see [What's new in 11](https://open-net-libraries.github.io/Open.Database.Extensions/articles/whats-new-11.html) for the changes, the breaking changes and the known limitations, and the [release notes](https://open-net-libraries.github.io/Open.Database.Extensions/articles/release-notes.html) for earlier versions. Please try it and tell us what you find.
Targets: `netstandard2.0`, `netstandard2.1` and `net10.0` (`MSSqlClient`: `net472` and `net10.0`). Version 11 is a release candidate (`11.0.0-rc.2`): see [What's new in 11](https://open-net-libraries.github.io/Open.Database.Extensions/articles/whats-new-11.html) for the changes, the breaking changes and the known limitations, and the [release notes](https://open-net-libraries.github.io/Open.Database.Extensions/articles/release-notes.html) for earlier versions. Please try it and tell us what you find.

## How it fits together

Expand Down
2 changes: 1 addition & 1 deletion Source/Directory.Build.props
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<VersionPrefix>11.0.0</VersionPrefix>
<VersionSuffix Condition="'$(Configuration)' == 'Debug'">debug</VersionSuffix>
<!-- Release candidate line: delete this element (or pass -p:VersionSuffix=) to build the stable 11.0.0 packages. -->
<VersionSuffix Condition="'$(Configuration)' != 'Debug'">rc.1</VersionSuffix>
<VersionSuffix Condition="'$(Configuration)' != 'Debug'">rc.2</VersionSuffix>

<!-- net10.0 is the primary/modern target. netstandard2.0/2.1 are retained as shimmed
legacy paths (via #if switching + BCL compat packages). net472 lives only on the
Expand Down
11 changes: 10 additions & 1 deletion docsite/articles/whats-new-11.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,19 @@
# What's new in 11

> [!NOTE]
> This is `11.0.0-rc.1`, a release candidate. The API is settled. Please try it and report what you find.
> This is `11.0.0-rc.2`, a release candidate. The API is settled. Please try it and report what you find.

Version 11 is a performance release and a tidy-up release. Result mapping is rewritten around a cached, typed row reader, column mapping is declared once, NULL and error handling follow simple rules, and stored-procedure parameters can be named from the arguments you already have. See [Performance](performance.md) for what the speed-up does and does not buy you. Coming from 10.x? Read "Upgrading from 10.x" below first.

## Changes since rc.1

- Generic commands (`ExpressiveCommand`, `ExpressiveDbCommand`) send each parameter's direction, so output parameters work.
- `AddParam(name, DbType, direction)` works on the SQL Server commands.
- `AddParams(x)` with `x` typed `object` sends the members of its real type.
- `AddParam(value)` finds a stored procedure's parameter names through the `ProcedureParameters` schema on any `DbConnection`.
- On a text command, `AddParam(value)` and `AddParams(object)` use the `@name` markers in the SQL.
- `Map<T>()` on a dictionary or `ExpandoObject` throws, where it used to return empty rows.

## Highlights

- **Faster, allocation-light mapping.** The mapping for a result-set shape is compiled once and cached, and values are read with typed getters, so nothing is boxed on the common path. Before, every `Map<T>()` compiled a setter per property (about 0.94 ms per query in the library's benchmark). In that benchmark (in-memory provider, 12-column rows, Dapper 2.1.89), reading 100 or more rows into a list or array takes 0.36 to 0.42 times Dapper's time (2.4 to 2.8 times faster) and 0.33 to 0.37 times its allocations (`Benchmarks/RESULTS.md`, re-measured on the release candidate; a positional record costs the same). Against SQL Server LocalDB the database dominates: times are 0.92 to 1.04 times Dapper's in that benchmark (0.89 to 1.08 in the re-run), within the noise, and allocations 0.55 to 0.6 times on multi-row results.
Expand Down