Skip to content

Commit b446241

Browse files
committed
cite AWS
1 parent a93678e commit b446241

File tree

1 file changed

+32
-17
lines changed

1 file changed

+32
-17
lines changed

Readme.md

Lines changed: 32 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ MyGet Pre-release feed: https://www.myget.org/gallery/dapper
2121
| [Dapper.StrongName](https://www.nuget.org/packages/Dapper.StrongName/) | [![Dapper.StrongName](https://img.shields.io/nuget/v/Dapper.StrongName.svg)](https://www.nuget.org/packages/Dapper.StrongName/) | [![Dapper.StrongName](https://img.shields.io/nuget/vpre/Dapper.StrongName.svg)](https://www.nuget.org/packages/Dapper.StrongName/) | [![Dapper.StrongName](https://img.shields.io/nuget/dt/Dapper.StrongName.svg)](https://www.nuget.org/packages/Dapper.StrongName/) | [![Dapper.StrongName MyGet](https://img.shields.io/myget/dapper/vpre/Dapper.StrongName.svg)](https://www.myget.org/feed/dapper/package/nuget/Dapper.StrongName) |
2222

2323
Package Purposes:
24+
* Dapper
25+
* The core library
2426
* Dapper.EntityFramework
2527
* Extension handlers for EntityFramework
2628
* Dapper.EntityFramework.StrongName
@@ -29,24 +31,44 @@ Package Purposes:
2931
* Micro-ORM implemented on Dapper, provides CRUD helpers
3032
* Dapper.SqlBuilder
3133
* Component for building SQL queries dynamically and composably
32-
* Dapper.StrongName
33-
* High-performance micro-ORM supporting MySQL, Sqlite, SqlICE, and Firebird
34+
35+
Sponsors
36+
--------
37+
38+
Dapper was originally developed for and by Stack Overflow, but is F/OSS. Sponsorship is welcome and invited - see the sponsor link at the top of the page.
39+
A huge thanks to everyone (individuals or organisations) who have sponsored Dapper, but a massive thanks in particular to:
40+
41+
- [AWS](https://github.com/aws) who sponsored Dapper from Oct 2023 via the [.NET on AWS Open Source Software Fund](https://github.com/aws/dotnet-foss)
3442

3543
Features
3644
--------
37-
Dapper is a [NuGet library](https://www.nuget.org/packages/Dapper) that you can add in to your project that will extend your `IDbConnection` interface.
45+
Dapper is a [NuGet library](https://www.nuget.org/packages/Dapper) that you can add in to your project that will enhance your ADO.NET connections via
46+
extension methods on your `DbConnection` instance. This provides a simple and efficient API for invoking SQL, with support for both synchronous and
47+
asynchronous data access, and allows bother buffered and non-buffered queries.
3848

39-
It provides 3 helpers:
49+
It provides multiple helpers, but the key APIs are:
4050

41-
Execute a query and map the results to a strongly typed List
42-
------------------------------------------------------------
51+
``` csharp
52+
// insert/update/delete etc
53+
var count = connection.Execute(sql [, args]);
4354

44-
```csharp
45-
public static IEnumerable<T> Query<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, bool buffered = true, int? commandTimeout = null, CommandType? commandType = null)
55+
// multi-row query
56+
IEnumerable<T> rows = connection.Query<T>(sql [, args]);
57+
58+
// single-row query ({Single|First}[OrDefault])
59+
T row = connection.QuerySingle<T>(sql [, args]);
4660
```
47-
Example usage:
4861

49-
```csharp
62+
where `args` can be (among other things):
63+
64+
- a simple POCO (including anonyomous types) for named parameters
65+
- a `Dictionary<string,object>`
66+
- a `DynamicParameters` instance
67+
68+
Execute a query and map it to a list of typed objects
69+
-------------------------------------------------------
70+
71+
``` csharp
5072
public class Dog
5173
{
5274
public int? Age { get; set; }
@@ -68,9 +90,6 @@ Assert.Equal(guid, dog.First().Id);
6890
Execute a query and map it to a list of dynamic objects
6991
-------------------------------------------------------
7092

71-
```csharp
72-
public static IEnumerable<dynamic> Query (this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, bool buffered = true, int? commandTimeout = null, CommandType? commandType = null)
73-
```
7493
This method will execute SQL and return a dynamic list.
7594

7695
Example usage:
@@ -87,10 +106,6 @@ Assert.Equal(4, (int)rows[1].B);
87106
Execute a Command that returns no results
88107
-----------------------------------------
89108

90-
```csharp
91-
public static int Execute(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)
92-
```
93-
94109
Example usage:
95110

96111
```csharp

0 commit comments

Comments
 (0)