AutoMapper 12.0.1
dotnet add package AutoMapper --version 12.0.1
NuGet\Install-Package AutoMapper -Version 12.0.1
<PackageReference Include="AutoMapper" Version="12.0.1" />
paket add AutoMapper --version 12.0.1
#r "nuget: AutoMapper, 12.0.1"
// Install AutoMapper as a Cake Addin
#addin nuget:?package=AutoMapper&version=12.0.1
// Install AutoMapper as a Cake Tool
#tool nuget:?package=AutoMapper&version=12.0.1
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:
- Microsoft DI Extensions
- Collection Extensions
- Expression Mapping
- EF6 Extensions
- IDataReader/Record Extensions
- Enum Extensions
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 net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.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 |
-
.NETStandard 2.1
- Microsoft.CSharp (>= 4.7.0)
NuGet packages (2.9K)
Showing the top 5 NuGet packages that depend on AutoMapper:
Package | Downloads |
---|---|
AutoMapper.Extensions.Microsoft.DependencyInjection
AutoMapper extensions for ASP.NET Core |
|
IdentityServer4.EntityFramework.Storage
EntityFramework persistence layer for IdentityServer4 |
|
AutoMapper.Collection
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
Abp.AutoMapper |
|
AutoMapper.Extensions.ExpressionMapping
Expression mapping (OData) extensions for AutoMapper |
GitHub repositories (286)
Showing the top 5 popular GitHub repositories that depend on AutoMapper:
Repository | Stars |
---|---|
BeyondDimension/SteamTools
🛠「Watt Toolkit」是一个开源跨平台的多功能 Steam 工具箱。
|
|
ppy/osu
rhythm is just a *click* away!
|
|
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
|
|
abpframework/abp
Open Source Web Application Framework for ASP.NET Core
|
|
IdentityServer/IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
|
Version | Downloads | Last updated |
---|---|---|
12.0.1 | 478,614 | 1/16/2023 |
12.0.0 | 6,811,423 | 9/30/2022 |
11.0.1 | 22,296,714 | 2/4/2022 |
11.0.0 | 13,118,623 | 1/5/2022 |
10.1.1 | 76,646,253 | 10/16/2020 |
10.0.0 | 27,099,908 | 7/1/2020 |
9.0.0 | 67,227,325 | 8/12/2019 |
8.1.1 | 12,580,700 | 6/3/2019 |
8.1.0 | 8,193,656 | 4/25/2019 |
8.0.0 | 26,245,851 | 11/17/2018 |
7.0.1 | 26,040,037 | 6/18/2018 |
7.0.0-alpha-0001 | 337,722 | 4/10/2018 |
6.2.2 | 15,114,220 | 12/6/2017 |
6.2.1 | 1,471,957 | 11/16/2017 |
6.2.0 | 442,265 | 11/9/2017 |
6.1.1 | 9,906,448 | 6/27/2017 |
6.1.0 | 693,548 | 6/14/2017 |
6.0.2 | 4,726,626 | 3/22/2017 |
5.2.0 | 5,106,872 | 11/23/2016 |
5.1.1 | 3,624,667 | 8/12/2016 |
5.0.2 | 1,370,814 | 7/7/2016 |
5.0.0-beta-1 | 47,776 | 5/17/2016 |
4.2.1 | 5,904,769 | 2/24/2016 |
4.2.0 | 941,501 | 1/28/2016 |
4.1.1 | 3,789,389 | 10/26/2015 |
4.0.4 | 2,029,582 | 8/6/2015 |
4.0.0-alpha1 | 21,848 | 7/7/2015 |
3.3.1 | 7,475,859 | 1/29/2015 |
3.3.0 | 1,078,754 | 11/29/2014 |
3.2.1 | 2,740,290 | 4/25/2014 |
3.1.1 | 1,063,046 | 12/31/2013 |
3.1.0 | 212,816 | 11/17/2013 |
3.0.0 | 1,383,742 | 8/25/2013 |
2.2.1 | 1,433,631 | 2/18/2013 |
2.2.0 | 437,790 | 9/22/2012 |
2.1.267 | 566,480 | 4/15/2012 |
2.1.266 | 35,255 | 3/29/2012 |
2.1.265 | 48,309 | 2/29/2012 |
2.1.262 | 47,517 | 2/29/2012 |
2.1.1 | 47,567 | 4/15/2012 |
2.0.0 | 391,626 | 9/22/2011 |
1.1.2 | 60,058 | 3/8/2017 |
1.1.0.118 | 1,006,689 | 9/7/2011 |