The object-to-object mapper for C# that can be setup in a readable one-liner. No Attributes, no configuration - just write intuitive and safe code that works immediately.
Get Started
$ dotnet add package XMapperReadme
XMapper
The object-to-object mapper for C# that can be setup in a readable one-liner. No Attributes, no configuration - just write intuitive and safe code that works immediately.
Available via NuGet.
Introduction
There's only one class in this package: XMapper<TSource, TTarget>. It has a single parameter of type PropertyList.
These are all the public methods:
IgnoreSourcePropertyIgnoreTargetPropertyIncludeActionMap(2 overloads)
Hovering over XMapper and its methods in your editor will provide guiding documentation.
Examples
using XMapper;
Map to new
var dummy1 = new Dummy1 { ... };
var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Source);
var dummy2 = mapper.Map(dummy1);
Map to exising
var d1 = new Dummy1 { ... };
var d2 = new Dummy2 { ... };
var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Target)
.IgnoreTargetProperty(x => x.Id);
mapper.Map(d1, d2);
Custom mapping of ValueTypes
var d1 = new Dummy1 { ... };
var d2 = new Dummy2 { ... };
var mapper = new XMapper<Dummy1, Dummy2>(PropertyList.Source)
.IgnoreSourceProperty(x => x.MyInt)
.IncludeAction((source, target) => target.MyInt = source.MyEnum > someValue ? null : source.Number * 10);
mapper.Map(d1, d2);
Map enumerable members to another target type
From Array to List with reference type elements:
var d1Xd2 = new XMapper<Dummy1, Dummy2>(PropertyList.Source);
var mapper = new XMapper<DummyA, DummyB>(PropertyList.Source)
.IgnoreSourceProperty(x => x.Dummy1Array)
.IncludeAction((source, target) => target.Dummy2List = source.Dummy1Array?.Select(x => d1Xd2.Map(x)).ToList());