AutoMapper 1.0 RTW

AutoMapper is now officially 1.0.  You can go grab the latest binaries here:

AutoMapper 1.0 RTW

Here are the release notes:

New Features

  • Changing the null substitute method name and allow any type of null substitute
  • Consolidating custom constructor configuration to just one
  • Adding UseValue option for member mappings when you want to just map from a single custom value
  • Added ValueFormatter


  • Adding custom mapping action objects (in addition to just functions)
  • Removing configuration validation from dynamic mapping
  • Adding overloads for mapping to existing objects for dynamic mapping
  • Modified ITypeConverter to only use ResolutionContext as the input
  • Added TypeConverter to ease generic scenarios
  • Custom value resolvers now have access to the current resolution context
  • Switching the MapFrom from using Expression to just Func, but with the return type retained
  • Some performance improvements around caching and sealing (only for Initialize scenarios)
  • Fixed profiles so you don’t have to provide a name (defaults to type name)

Bugs Fixed

  • Fixed bug where a zero-length sequence would throw an exception
  • Applying patch to fix duplicate CreateMap call issue
  • Fixing bug where type map resolution did not attempt to find a map for the underlying member type
  • Fixed bug where destination collections were not cleared before mapping
  • Integrating patch to fix ambiguous match exceptions on multiple IEnumerable implementors
  • Fixed bug where read-only string destination properties had to be marked as ignored
  • Applied patch to fix issue where the DataReader mapper blew up on nullable fields
  • Fixing bug where a bi-directional relationship with an array was messing up
  • Fixed bug where type-specific formatters were not found correctly at the global level

I tried to get all the documentation done…and failed.  Instead, I’m building up a comprehensive set of examples first.  So what’s up for the next release?  Here’s my current plan of action:

  1. Move source to github – DVCS better suited for OSS anyway
  2. Get build/deployment/TeamCity.CodeBetter migrated to github
  3. Add in patches for SL 3.0, CF and Mono (and integrate into the build)
  4. Look at

And as always, if you have any questions, feel free to post them up on StackOverflow or put them on the mailing list.  The mailing list shows up in my inbox, while the SO posts show up in my feed reader, so I may not personally answer SO posts right away (but others tend to first).  Enjoy!

Evolutionary Architecture