Skip to content
Jaxel Rojas edited this page May 16, 2018 · 44 revisions

Insight.Database is a fast, lightweight, (and dare we say awesome) micro-orm for .NET.

It's available as a NuGet Package, install with:

PM> Install-Package Insight.Database

Why You Want Insight.Database

It just works...

  • Without a lot of effort or configuration.

It's fast...

  • Mappers are generated IL code, not runtime reflection.
  • Mappings are cached.
  • Optimized for SequentialAccess.
  • Async operations are first-class operations.

It's easy...

  • Automatically maps fields/properties to parameters.
  • Automatically maps columns to fields/properties.
  • Automatic one-to-one, one-to-many, many-to-many, and multi-recordset support.
  • Wire up an interface definition right to database calls.
  • Generic extension methods automatically handle type safety for you.

It's flexible...

  • It works with all of the common databases and tools.
  • It supports structured, production quality coding.
  • It also supports ad-hoc, one-off, typeless, get-it-done coding.
  • Use stored procedures or inline SQL.
  • Use POCOs or dynamics.
  • Awesome type conversion support. Never worry about mismatches between property types and column types.
  • Override mappings through attributes or configuration. Or not.
  • Extend the system with your own readers if you need to. Or not.

It's advanced...

  • Support for BulkCopy (most providers)
  • Support for cloud providers through ReliableConnection
  • Support for optimistic concurrency through OptimisticConnection

It's documented...

  • Take that, most of you other open-source projects!

Before You Begin

The documentation below is written so that you understand Insight from the ground up. Regardless of your coding style, If you read it in order, you will find ways to make your database code simpler and easier.

Of course, what I really want you to do is to switch over to Auto Interface Implementation. So please read at least that far before you get too excited and start coding.

A Quick Tour

Getting Started

Executing Queries

Common Query Scenarios

Object Mapping

Specifying Result Structures

Doing it the Right Way

Nits and Gnats

Data Types

Dynamic Objects and Queries

Performance & Speed

Database Providers

Test & Profiling Framework Providers

Revision History

Other Stuff

Clone this wiki locally