PerformantReflection 1.4.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package PerformantReflection --version 1.4.0                
NuGet\Install-Package PerformantReflection -Version 1.4.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="PerformantReflection" Version="1.4.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add PerformantReflection --version 1.4.0                
#r "nuget: PerformantReflection, 1.4.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 PerformantReflection as a Cake Addin
#addin nuget:?package=PerformantReflection&version=1.4.0

// Install PerformantReflection as a Cake Tool
#tool nuget:?package=PerformantReflection&version=1.4.0                

PerformantReflection

A super small library for making Reflection FAST.

The current version exposes Properties, allowing you to read their values as well as write new values with basically no performance penalty compared to when not using Reflection. It also has a sped-up version of the .Net built-in Activator.CreateInstance: TypeInstantiator.CreateInstance.

This is archived by reflecting types just once, and emitting IL to create new dynamic methods. Finally a delegate is cached for these dynamic methods, and invoking these delegates has basically no performance penalty.

Installation

I recommend using the NuGet package: PerformantReflection however feel free to clone the source instead if that suits your needs better.

Usage

For properties

Simply instantiate an ObjectAccessor and feed it the object you want to access. Then you can loop over the Properties, index into them with ["PropertyName"] or use TryGetValue if you're unsure whether the property even exists:

Examples:

class User {
	public string Username { get;set; }
}

var user = new User {
	Username = "Old username"
};

var accessor = new ObjectAccessor(user);

var existingUsername = accessor.Properties["Username"].GetValue();

accessor.Properties["Username"].SetValue("New username");

For instantiating types

Simply call TypeInstantiator.CreateInstance(someType) similar to how you would with Activator.CreateInstance - it's that simple 😃

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net5.0

    • 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
1.8.1 33,105 5/3/2024
1.8.0 558 4/27/2024
1.7.6 715 3/26/2024
1.7.5 5,593 1/13/2024
1.7.4 5,598 11/11/2023
1.7.3 582 9/20/2023
1.7.2 860 6/29/2023
1.7.1 588 6/12/2023
1.7.0 162 6/12/2023
1.6.0 200 6/9/2023
1.5.1 432 5/31/2023
1.5.0 159 5/30/2023
1.4.0 193 5/9/2023
1.3.0 2,398 10/4/2022
1.2.1 407 7/23/2022
1.2.0 408 6/23/2022
1.1.1 415 6/20/2022
1.1.0 400 6/20/2022
1.0.0 1,547 5/9/2022