StoredProcedureEFCore 0.3.2

Execute stored procedures with Entity Framework Core

DbContext extension with LoadStoredProc method which creates an IStoredProcBuilder to build a stored procedure with a custom mapping strategy using the provided DbDataReader extension.

The method handles :

• Extra column in result set
• Extra property in model
• Null values in result set
• Underscores in result set column names ("column_name" is mapped to ColumnName property)
• Int (db) to enumeration (result model) mapping

Example

List<Model> rows = null;

ctx.LoadStoredProc("dbo.ListAll")
   .AddParam("limit", 300L)
   .AddParam("limitOut", out IOutParam<long> limitOut)
   .Exec(r => rows = r.ToList<Model>());

long limitOutValue = limitOut.Value;

ctx.LoadStoredProc("dbo.ReturnBoolean")
   .AddParam("boolean_to_return", true)
   .ReturnValue(out IOutParam<bool> retParam)
   .ExecNonQuery();

bool b = retParam.Value;

ctx.LoadStoredProc("dbo.ListAll")
   .AddParam("limit", 1L)
   .ExecScalar(out long l);

API

DbContext

IStoredProcBuilder             LoadStoredProc(string name)

DbDataReader

List<T>                              ToList<T>()
Task<List<T>>                        ToListAsync<T>()
Dictionary<TKey, TValue>             ToDictionary<TKey, TValue>()
Task<Dictionary<TKey, TValue>>       ToDictionaryAsync<TKey, TValue>()
Dictionary<TKey, List<TValue>>       ToLookup<TKey, TValue>()
Task<Dictionary<TKey, List<TValue>>> ToLookupAsync<TKey, TValue>()
HashSet<T>                           ToSet<T>()
Task<HashSet<T>>                     ToSetAsync<T>()
List<T>                              Column<T>()
List<T>                              Column<T>(string columnName)
Task<List<T>>                        ColumnAsync<T>()
Task<List<T>>                        ColumnAsync<T>(string columnName)
T                                    First<T>()
Task<T>                              FirstAsync<T>()
T                                    FirstOrDefault<T>()
Task<T>                              FirstOrDefaultAsync<T>()
T                                    Single<T>()
Task<T>                              SingleAsync<T>()
T                                    SingleOrDefault<T>()
Task<T>                              SingleOrDefaultAsync<T>()

IStoredProcBuilder

IStoredProcBuilder                   AddParam<T>(string name, T val)                             // Input parameter
IStoredProcBuilder                   AddParam<T>(string name, T val, out OutParam<T> outParam)   // Input/Ouput parameter
IStoredProcBuilder                   AddParam<T>(string name, out IOutParam<T> outParam)         // Ouput parameter
IStoredProcBuilder                   ReturnValue<T>(out IOutParam<T> retParam)
void                                 Exec(Action<DbDataReader> action)
Task                                 ExecAsync(Func<DbDataReader, Task> action)
void                                 ExecNonQuery()
Task                                 ExecNonQueryAsync()
void                                 ExecScalar<T>(out T val)
Task                                 ExecScalarAsync<T>(Action<T> action)

Installation

Install-Package StoredProcedureEFCore

Why ?

Stored procedure execution is not supported in entity framework core:

• Raw store access APIs: Support for ad hoc mapping of arbitrary types #1862
• Stored procedure mapping support #245