get via nuget ValueInjecter
usage
var customerInput = Mapper.Map<CustomerInput>(customer);
or like this:
//# in previous example type of the source (from) was being inferred from the `customer` variable
var customerInput = Mapper.Map<Customer, CustomerInput>(customer);
(useful when working with EF proxy objects)
by default it will only map properties with the exact same name and type, but this can be changed by adding custom maps for types that have different properties
custom maps
can be added, like this:
Mapper.AddMap<FromType, ResType>(src =>
{
var res = new ResType();
res.InjectFrom(src); // maps properties with same name and type
res.FullName = src.FirstName + " " + src.LastName;
return res;
});
map to existing object
Mapper.AddMap<Customer, Customer>((from, tag) =>
{
var existing = tag as Customer;
existing.InjectFrom(from);
return existing;
});
var customer = GetCustomer();
var res = new Customer();
Mapper.Map<Customer>(customer, res);
InjectFrom
InjectFrom<TInjection>(source)
is used to map using a convention, when TInjection
is not specified it will map properties with exact same name and type
it's used like this:
target.InjectFrom(source);
target.InjectFrom<Injection>(source);
target.InjectFrom(new Injection(parameters), source);
target.InjectFrom<Injection>(); // without source
you can create you own injections by inheriting LoopInjection
, PropertyInjection
and other base injections
see some examples of custom injections here: [injections examples] (https://github.com/omuleanu/ValueInjecter/wiki/custom-injections-examples)
Additional parameters
an additional parameter can be set when mapping:
var customer = Mapper.Map<Customer>(foo, new MyClass { Title = "hi" });
you can use this parameter in AddMap like this:
Mapper.AddMap<Foo, Customer>((src, tag) =>
{
var par = (MyClass)tag;
var res = new Customer { LastName = par.Title };
...
return res;
});
when using InjectFrom additional parameters can be sent to the injection:
res.InjectFrom(new LoopInjection(new[] { "FirstName" }), customer);
in this case LoopInjection will ignore "FirstName" property; you can add private fields to your custom injections and give them value via the constructor as shown above
Flattening and unflattening
you can use FlatLoopInjection
and UnflatLoopInjection
directly or inherit them, you can also use the UberFlatter
class in you custom injections, have look at the source code for these injections.
Default map
For pairs of types that don't have a mapping created using Mapper.AddMap
, there's a default map being used.
This default map will only map properties with the exact same name and type, this can be changed by setting Mapper.DefaultMap
, here's an example that sets the default map:
Mapper.DefaultMap = (src, resType, tag) =>
{
// this is the source code of default map
var res = Activator.CreateInstance(resType);
res.InjectFrom(src);
return res;
};
So if you call Mapper.Map<Customer>(customerInput)
and before you've created a map using Mapper.AddMap<CustomerInput, Customer>
Default InjectFrom
You can change the default injection by setting
StaticValueInjecter.DefaultInjection = new MyInjection();
Multiple mappers
Multiple mappers with different configurations can be used by creating multiple instances of MapperInstance
var mapper1 = new MapperInstance();
var mapper2 = new MapperInstance();
mapper1.AddMap<Customer, CustomerInput>((from) =>
{
var input = new CustomerInput();
input.InjectFrom(from);
return input;
});
mapper2.AddMap<Customer, CustomerInput>((from) =>
{
var input = new CustomerInput();
input.FirstName = from.FirstName;
return input;
});
var input1 = mapper1.Map<CustomerInput>(customer);
var input2 = mapper2.Map<CustomerInput>(customer); // has only FirstName set
you could store the instance in a static member, or use your IoC Container
Samples
there's samples in the source code for winforms, ASP.net web-forms, DAL, and wpf
deep cloning sample here, and the CloneInjection
for ASP.net MVC see http://prodinner.codeplex.com
questions: http://stackoverflow.com/questions/tagged/valueinjecter