configuration-reference.md

title	Configuration Reference
description	Compare global, isolated, profile, convention, and generated configuration.

Home/Reference/Configuration Reference

Required package: Dapper.FluentMap

Problem solved

Compare global, isolated, profile, convention, and generated configuration.

When to use it

Use this capability when the column shape and .NET model should remain separated by explicit, reviewable configuration.

Example

public sealed class CustomerMap : EntityMap<Customer>
{
    public CustomerMap()
    {
        Map(x => x.Id).ToColumn("customer_id");
        Map(x => x.Name).ToColumn("customer_name");
    }
}

How it works

FluentMap registers typed metadata and applies it through the matching materialization path. SQL, connections, parameters, and lifecycle remain responsibilities of the application and Dapper.

Constraints

:::caution Initialize before concurrent queries and treat the effective configuration as read-only afterward. :::

Related references

• Compatibility contract
• Changelog