ExIgniter.ObjectMapper
2.0.2
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package ExIgniter.ObjectMapper --version 2.0.2
NuGet\Install-Package ExIgniter.ObjectMapper -Version 2.0.2
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="ExIgniter.ObjectMapper" Version="2.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ExIgniter.ObjectMapper" Version="2.0.2" />
<PackageReference Include="ExIgniter.ObjectMapper" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ExIgniter.ObjectMapper --version 2.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: ExIgniter.ObjectMapper, 2.0.2"
#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.
#:package ExIgniter.ObjectMapper@2.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ExIgniter.ObjectMapper&version=2.0.2
#tool nuget:?package=ExIgniter.ObjectMapper&version=2.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
ExIgniter.ObjectMapper 2.0
ExIgniter.ObjectMapper is an intelligent, high-performance object mapping library for .NET.
Version 2.0 delivers:
- 🚀 Drastically improved performance
- 🔐 Safe mapping with circular reference detection
- 🧠 Smart property matching
- 🧱 Deep support for collections and complex graphs
✨ Why ExIgniter?
- ✅ Zero-configuration for 90% of use cases
- ✅ 3x faster than v1.0 in benchmarks
- ✅ Automatically matches similar property names
- ✅ Safely maps nested objects, collections, and dictionaries
- ✅ Security-first: detects circular references, restricts unsafe types, and limits recursion depth
📦 Installation
Install-Package ExIgniter.ObjectMapper
Supports: .NET Standard 2.1+, .NET 6+, .NET 7+
🔑 Key Features
🚀 Performance Optimized
- Reflection caching
- Lazy initialization
- Minimal allocations
🧠 Intelligent Mapping
Automatically resolves common mismatches:
"UserName" → "Username"
"Addr1" → "AddressLine1"
"ID" → "Id"
🔐 Safe and Secure
- Cycle detection using object graph tracking
- Max depth limit to prevent runaway recursion
- Whitelisted types to avoid instantiating unsafe types
🧰 Collection Support
- Arrays, Lists, HashSets
- Dictionaries
- Queues and Stacks
📊 Benchmarks (v1.0 vs v2.0)
| Scenario | v1.0 | v2.0 | Speedup |
|---|---|---|---|
| Simple Object | 150ms | 50ms | 3× |
| Complex Graph | 420ms | 140ms | 3× |
| Collection (1k) | 220ms | 70ms | 3.1× |
Benchmarks were performed using representative DTOs and nested entities.
📚 Documentation
- Full API reference
- Configuration guide
- Migration steps from v1.x to v2.0
🤝 Contributing
We welcome contributions! Please see the Contribution Guidelines.
📄 License
MIT License — free for commercial and personal use.
Happy mapping! 🎯
| Product | Versions 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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.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 |
|---|---|---|
| 3.0.2 | 169 | 5/24/2025 |
| 3.0.0 | 100 | 5/24/2025 |
| 2.0.2 | 174 | 5/22/2025 |
| 2.0.1 | 199 | 5/22/2025 |
| 2.0.0 | 189 | 5/22/2025 |
| 1.1.0 | 2,294 | 4/10/2019 |
| 1.0.9 | 793 | 3/29/2019 |
| 1.0.8 | 794 | 3/29/2019 |
| 1.0.7 | 790 | 3/21/2019 |
| 1.0.6 | 799 | 3/18/2019 |
| 1.0.4 | 792 | 3/18/2019 |
| 1.0.3 | 884 | 2/8/2019 |
| 1.0.2 | 834 | 2/7/2019 |
| 1.0.1 | 860 | 2/7/2019 |
| 1.0.0 | 878 | 2/6/2019 |