HatTrick.Reflection 3.0.1

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher. 
dotnet add package HatTrick.Reflection --version 3.0.1
                    


                    

                
NuGet\Install-Package HatTrick.Reflection -Version 3.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="HatTrick.Reflection" Version="3.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="HatTrick.Reflection" Version="3.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="HatTrick.Reflection" />
                    


                            Project file
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 HatTrick.Reflection --version 3.0.1
                    


                    

                
#r "nuget: HatTrick.Reflection, 3.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. 
#:package HatTrick.Reflection@3.0.1
#: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=HatTrick.Reflection&version=3.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=HatTrick.Reflection&version=3.0.1
                    


                            Install as a Cake Tool

HatTrick.Reflection

NuGet License: Apache-2.0

Reflect properties, fields, or dictionary values off any object using dotted-path expressions, with optional compiled-delegate helpers for hot paths.

NuGet | hattricklabs.com

Installation

dotnet add package HatTrick.Reflection

Quick Start

using HatTrick.Reflection;

var person = new Person
{
    FirstName = "Charlie",
    BillingAddress = new Address { City = "Plano", State = "TX" }
};

// Properties, fields, and dotted paths through nested objects.
string firstName = person.ReflectItem<string>("FirstName");
string city = person.ReflectItem<string>("BillingAddress.City");

// Works on dictionaries and anonymous types too — same expression syntax.
var dict = new Dictionary<string, object> { ["Name"] = "Jorge" };
string name = dict.ReflectItem<string>("Name");

// Returns null instead of throwing when a path segment doesn't exist.
string middleName = person.ReflectItem<string>("MiddleName", throwOnNoItemExists: false);

// Register a compiled delegate for a (type, expression) pair to skip reflection on hot paths.
ReflectionHelper.Expression.RegisterHelper<Person>("BillingAddress.City", p => p.BillingAddress?.City);
city = person.ReflectItem<string>("BillingAddress.City"); // now resolved via the delegate

Features

  • Reflect properties, fields, or dictionary values through dotted-path expressions, recursing through nested objects
  • Works uniformly across POCOs, anonymous types, and IDictionary<string, object>
  • RegisterHelper<T> swaps in a compiled delegate per type/expression pair, bypassing reflection entirely on hot paths
  • Configurable null-or-throw behavior (NoItemExistsException) when a path segment doesn't resolve
  • Guards against runaway recursive paths via RecursionStackDepthException (max depth 16)

License

Apache-2.0 — see LICENSE.

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

  • net9.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on HatTrick.Reflection:

Package Downloads
HatTrick.Text.Templating

Text templating utilities.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.1 138 6/20/2026
3.0.0 108 5/19/2026
2.0.0 244 10/5/2025
1.0.6 1,218 10/3/2022
1.0.5 2,759 9/9/2020
1.0.4 812 3/2/2019
1.0.3 1,930 12/21/2018
1.0.2 851 12/21/2018
1.0.1 850 12/21/2018
1.0.0 910 12/19/2018

Implemented max stack depth for recursive binding (16).