Mshwf.Charger 2.1.0

dotnet add package Mshwf.Charger --version 2.1.0                
NuGet\Install-Package Mshwf.Charger -Version 2.1.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.
<PackageReference Include="Mshwf.Charger" Version="2.1.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Mshwf.Charger --version 2.1.0                
#r "nuget: Mshwf.Charger, 2.1.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Mshwf.Charger as a Cake Addin
#addin nuget:?package=Mshwf.Charger&version=2.1.0

// Install Mshwf.Charger as a Cake Tool
#tool nuget:?package=Mshwf.Charger&version=2.1.0                

Charger

What is Charger?

Charger is an object mapper, for easily mapping between properties in two objects. The library has 4 methods as follows:

  • ChargeFrom (2 overloads)
  • Squeeze<TTarget> (2 overloads)

Get started

For explaining the use of Charger consider these two example classes:

public class Item
{
    public int ItemId { get; set; }
    public string ItemName { get; set; }
    public string Category { get; set; }
    public string Url { get; set; }
    public Category Cat { get; set; }

}
public class ItemViewModel
{
    public int Id { get; set; }
    public string ItemName { get; set; }
    public string Category { get; set; }
    public string Url { get; set; }
    public DateTime DateUpdated { get; set; }
    public CategoryVM CatVm { get; set; }
}

ChargeFrom

  • If you have an object of type ItemViewModel and you want to map its properties to an Item object, easily call the ChargeFrom extension method on the target object (ItemViewModel object), like so:
itemVm.ChargeFrom(item);

Similarily, you can do the same with lists:

itemsVm.ChargeFrom(items);

Note:

  • Target's properties that are not exist (with the same name and type) on the source object will not change, so the DateUpdated property will not touched by Charger.
  • If the target list contains items, Charger will just add to them from the source.

Attributes

There are 3 attributes to use on the target properties:

  • NotCharged Use this attribute on properties you don't want to charge.

  • SourceProperty(propertyName) Use this attribute on target properties that have different names than the source property. for the ItemViewModel class you can charge the Id property from the ItemId on the Item class:

[SourceProperty("ItemId")]
public int Id { get; set; }

It will throw a null reference exception if the proprty doesn't exist on the source object, to ignore the exception, set the attribute's property AlwaysOnSource to false:

[SourceProperty("ItemId", AlwaysOnSource = false)]
public int Id { get; set; }
  • DeepCharging

So far, the charging is achieved for properties that share the same type, but if you want to charge a custom property type from another custom property type, in the example above: CatVm property from Cat you can use DeepCharging attribute, but since they have different names, you'll need to combine it with the SourceProperty attribute to specify the source's property name:

[DeepCharging, SourceProperty("Cat")]
public CategoryVM CatVm { get; set; }

The DeepCharging uses ChargeFrom method internally, so the target property should be initialized (not null), otherwise, it will throw a null reference exception, as a workaround you can initialize it using auto-properties:

public CategoryVM CatVm { get; set; } = new CategoryVm();

But you can ignore charging it if it's null, by setting NullTargetAction to NullTargetAction.IgnoreCharging.

Squeeze

So far to use Charger you should have an initialized target object. But if all what you want is getting a fresh object out of another object, you can use Squeeze method that will just get you a specified object type:

var newItemModel = item.Squeeze<ItemViewModel>();  //for one object
var newItemsModel = items.Squeeze<ItemViewModel>(); //for list of objects

Install

PM> Install-Package Mshwf.Charger

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.1

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0 770 2/14/2020
2.0.0 1,226 10/5/2017
1.3.2 1,207 9/24/2017
1.0.0 1,428 5/13/2017

The library has been ported to .NET Standard 2.1