DEV Community

Cover image for Add AutoMapper to .Net 6
Mohamad Lawand
Mohamad Lawand

Posted on

Add AutoMapper to .Net 6

In this article we will be adding AutoMapper to our AspNetCore 6 application.

You can watch the full video on Youtube

The first thing we need to do is add the packages

dotnet add package AutoMapper --version 10.1.1
dotnet add package AutoMapper.Extensions.Microsoft.DependencyInjection --version 8.1.1
Enter fullscreen mode Exit fullscreen mode

The next step is adding the AutoMapper to our DI container, inside the program.cs we need to add the following

builder.Services.AddAutoMapper(AppDomain.CurrentDomain.GetAssemblies());
Enter fullscreen mode Exit fullscreen mode

Now its time to create our AutoMapper profiles, so on the root directory of our application we need to create a folder called Profiles, inside the Profiles folder we will create a new class called UserProfile ("We can call the class anything we want, but per convention we need to name the class based on the entity we want to map as well add the word profile to it").

We are going to map the below entity ("User") to the a Dto ("UserDto")

public class User
    {
        public Guid Id { get; set; }
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public string Email { get; set; }
        public string Phone { get; set; }
        public DateTime DateOfBirth { get; set; }
        public string Country { get; set; }
        public string Address { get; set; }
        public string MobileNumber { get; set; }
        public string Sex { get; set; }
    }
Enter fullscreen mode Exit fullscreen mode
public class UserDto
    {
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public string Email { get; set; }
        public string Phone { get; set; }
        public string DateOfBirth { get; set; }
        public string Country { get; set; }
    }
}
Enter fullscreen mode Exit fullscreen mode

Now inside the UserProfile class we need to add the following

public class UserProfile : Profile
    {
        public UserProfile()
        {
            CreateMap<UserDto, User>()
                .ForMember(
                    dest => dest.FirstName,
                    opt => opt.MapFrom(src => $"{src.FirstName}")
                )
                .ForMember(
                    dest => dest.LastName,
                    opt => opt.MapFrom(src => $"{src.LastName}")
                )
                .ForMember(
                    dest => dest.Email,
                    opt => opt.MapFrom(src => $"{src.Email}")
                )
                .ForMember(
                    dest => Convert.ToDateTime(dest.DateOfBirth),
                    opt => opt.MapFrom(src => $"{src.DateOfBirth}")
                )
                .ForMember(
                    dest => dest.Phone,
                    opt => opt.MapFrom(src => $"{src.Phone}")
                )
                .ForMember(
                    dest => dest.Country,
                    opt => opt.MapFrom(src => $"{src.Country}")
                )
                .ForMember(
                    dest => dest.Status,
                    opt => opt.MapFrom(src => 1)
                );
        }
    }
Enter fullscreen mode Exit fullscreen mode

The UserProfile class MUST inherit from Profile class in order for AutoMapper to recognise it.

Inside the constructor we define the mapping between the Entity and the Dto.

Once we complete our profile mapping its now to utilise our new map in our controller.

public class UsersController : ControllerBase
{
    public IUnitOfWork _unitOfWork;
    // define the mapper
    public readonly IMapper _mapper;

    // initialise the dependencies with constructor initialisation
    public UsersController(
        IMapper mapper,
        IUnitOfWork unitOfWork)
    {   
        _mapper = mapper;
        _unitOfWork = unitOfWork;
    }

    [HttpPost]
    public async Task<IActionResult> AddUser(UserDto user)
    {
        // utilise the mapping :)
        var _mappedUser = _mapper.Map<User>(user);

        await _unitOfWork.Users.Add(_mappedUser);
        await _unitOfWork.CompleteAsync();

        var result = new Result<UserDto>();
        result.Content = user;

        return CreatedAtRoute("GetUser", new { id = _mappedUser.Id}, result); // return a 201
    }
}
Enter fullscreen mode Exit fullscreen mode

So basically we need to initialise the mapper with constructor initialisation.

Then we need to utilise as follow

        var _mappedUser = _mapper.Map<Entity>(dto);
Enter fullscreen mode Exit fullscreen mode

AutoMapper is a powerful tool to keep in our toolset while developing any .Net applications.

Discussion (3)

Collapse
chadwinjdeysel profile image
Chadwin Deysel

Thank you for posting this, was really stuck until I found this post 🙌

Collapse
grobian profile image
grobian

Hi, I get this error:

The type or namespace name 'Result<>' could not be found (are you missing a using directive or an assembly reference?)

Where does Result() come from?

Collapse
dejankaranovicprivate profile image
dejankaranovicprivate

Great!