AutoMapper 12.0.0

.NET Standard 2.1
NuGet\Install-Package AutoMapper -Version 12.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
dotnet add package AutoMapper --version 12.0.0
<PackageReference Include="AutoMapper" Version="12.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AutoMapper --version 12.0.0
#r "nuget: AutoMapper, 12.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install AutoMapper as a Cake Addin
#addin nuget:?package=AutoMapper&version=12.0.0

// Install AutoMapper as a Cake Tool
#tool nuget:?package=AutoMapper&version=12.0.0

AutoMapper

CI NuGet MyGet (dev)

What is AutoMapper?

AutoMapper is a simple little library built to solve a deceptively complex problem - getting rid of code that mapped one object to another. This type of code is rather dreary and boring to write, so why not invent a tool to do it for us?

This is the main repository for AutoMapper, but there's more:

How do I get started?

First, configure AutoMapper to know what types you want to map, in the startup of your application:

var configuration = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<Foo, FooDto>();
    cfg.CreateMap<Bar, BarDto>();
});
// only during development, validate your mappings; remove it before release
#if DEBUG
configuration.AssertConfigurationIsValid();
#endif
// use DI (http://docs.automapper.org/en/latest/Dependency-injection.html) or create the mapper yourself
var mapper = configuration.CreateMapper();

Then in your application code, execute the mappings:

var fooDto = mapper.Map<FooDto>(foo);
var barDto = mapper.Map<BarDto>(bar);

Check out the getting started guide. When you're done there, the wiki goes in to the nitty-gritty details. If you have questions, you can post them to Stack Overflow or in our Gitter.

Where can I get it?

First, install NuGet. Then, install AutoMapper from the package manager console:

PM> Install-Package AutoMapper

Or from the .NET CLI as:

dotnet add package AutoMapper

Do you have an issue?

First check if it's already fixed by trying the MyGet build.

You might want to know exactly what your mapping does at runtime.

If you're still running into problems, file an issue above.

License, etc.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

AutoMapper is Copyright © 2009 Jimmy Bogard and other contributors under the MIT license.

.NET Foundation

This project is supported by the .NET Foundation.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2.7K)

Showing the top 5 NuGet packages that depend on AutoMapper:

Package Downloads
AutoMapper.Extensions.Microsoft.DependencyInjection The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

AutoMapper extensions for ASP.NET Core

IdentityServer4.EntityFramework.Storage The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

EntityFramework persistence layer for IdentityServer4

AutoMapper.Collection The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Collection Add/Remove/Update support for AutoMapper. AutoMapper.Collection adds EqualityComparison Expressions for TypeMaps to determine if Source and Destination type are equivalent to each other when mapping collections.

Abp.AutoMapper The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Abp.AutoMapper

AutoMapper.Extensions.ExpressionMapping The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Expression mapping (OData) extensions for AutoMapper

GitHub repositories (264)

Showing the top 5 popular GitHub repositories that depend on AutoMapper:

Repository Stars
ppy/osu
rhythm is just a *click* away!
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
IdentityServer/IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
abpframework/abp
Open Source Web Application Framework for ASP.NET Core
Version Downloads Last updated
12.0.0 17 9/30/2022
11.0.1 11,246,603 2/4/2022
11.0.0 7,678,200 1/5/2022
10.1.1 60,529,359 10/16/2020
10.0.0 22,875,006 7/1/2020
9.0.0 59,369,075 8/12/2019
8.1.1 11,357,787 6/3/2019
8.1.0 7,521,633 4/25/2019
8.0.0 24,265,746 11/17/2018
7.0.1 23,681,568 6/18/2018
7.0.0-alpha-0001 332,565 4/10/2018
6.2.2 14,085,379 12/6/2017
6.2.1 1,391,724 11/16/2017
6.2.0 417,706 11/9/2017
6.1.1 9,308,539 6/27/2017
6.1.0 652,169 6/14/2017
6.0.2 4,400,510 3/22/2017
5.2.0 4,769,498 11/23/2016
5.1.1 3,428,438 8/12/2016
5.0.2 1,298,420 7/7/2016
5.0.0-beta-1 46,337 5/17/2016
4.2.1 5,574,792 2/24/2016
4.2.0 887,669 1/28/2016
4.1.1 3,494,856 10/26/2015
4.0.4 1,876,536 8/6/2015
4.0.0-alpha1 21,744 7/7/2015
3.3.1 6,905,235 1/29/2015
3.3.0 1,017,528 11/29/2014
3.2.1 2,548,410 4/25/2014
3.1.1 977,504 12/31/2013
3.1.0 204,752 11/17/2013
3.0.0 1,204,894 8/25/2013
2.2.1 1,300,193 2/18/2013
2.2.0 421,050 9/22/2012
2.1.267 526,551 4/15/2012
2.1.266 34,455 3/29/2012
2.1.265 47,093 2/29/2012
2.1.262 36,009 2/29/2012
2.1.1 42,913 4/15/2012
2.0.0 366,050 9/22/2011
1.1.2 55,473 3/8/2017
1.1.0.118 956,989 9/7/2011