Reflector.Mapper
1.0.1
dotnet add package Reflector.Mapper --version 1.0.1
NuGet\Install-Package Reflector.Mapper -Version 1.0.1
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="Reflector.Mapper" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Reflector.Mapper --version 1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Reflector.Mapper, 1.0.1"
#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 Reflector.Mapper as a Cake Addin #addin nuget:?package=Reflector.Mapper&version=1.0.1 // Install Reflector.Mapper as a Cake Tool #tool nuget:?package=Reflector.Mapper&version=1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Usage
var client = Reflector.Create<Client>()
.Set("Id", "a65s4d6a5s")
.Set("Domain", "www.some-client.com")
.Set("RegisteredAt", DateTime.UtcNow)
.Set("platforms", new[] { 1, 2, 3 }) // field
.GetInstance();
// Or supply your own instance
var another = Reflector.Using(new Client())
.Set("Id", "a65s4d6a5s")
.Set("Domain", "www.some-client.com")
.GetInstance();
Key points:
- The class must provide a parameterless constructor (it may be private);
- Property/field names are case-insensitive;
- Property/fields can be private;
- Fields are searched with the following patterns:
field
,_field
,mField
,m_field
; - Does not work with
const
andreadonly
fields, nor properties withoutset
.
Performance notes
The implementation has been optimized with caching.
The first time a constructor, property setter or field setter are used, Reflector builds and caches the constructor or setter as a delegate, which allows for repeating the operations in a static fashion. This means that subsequent calls are almost as fast as instantiating classes and setting properties/fields by hand (i.e. without a mapping helper).
Covered test cases
- Can create class with public constructor
- Can create class with private constructor
- Can set public property
- Can set private property
- Can set nullable property
- Can set field
- Can set property regardless of case
- Can work with supplied instance
- Property is preferred over field when names collide
- Non-existent property or field returns InvalidOperationException
- Static property or field returns InvalidOperationException
- Readonly property or field returns InvalidOperationException
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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. 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.
-
- System.Reflection.Emit.Lightweight (>= 4.3.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Added support for working with supplied instances.