ExpressWalker provides a generic way to examine and change any object graph in fashion similar to "Visitor Pattern". You can build generic hierarchy composition (visitor) capable to "visit" and change any property, basing on configuration. Uses refleciton only while building a visitor and relies purely on expression trees while visiting objects.

That's why IT IS WAY FASTER than custom solutions usually built with reflection.

It is optionally protected from circular references so you can avoid StackOverflowException easily. Provides fluent API while building a visitor which increases code readability in terms of recognizing the hierarchy being built right away from the code. The optional and configurable things available are:

visiting properties by matching owner type and property name
visiting properties by matching property type only
specifying depth of visit in run-time (not during configuration)
custom expression for changing property value
cloning of visited object

//building a visitor + visiting an object (with optional clone, visit depth and circular reference protection):

var visitor = TypeWalker<Parent>.Create()
                 .ForProperty<Parent, string>(p => p.TestString1, null, (old, met) => old + met)
                 .ForProperty<Child, DateTime>(p => p.TestDate1, null, (old, met) => old.AddYears(10))
                 .ForProperty<CommonType>(null, (old, met) => new CommonType { CommonString = "..." })

 var parentClone = new Parent();

 visitor.Visit(parentObject, parentClone, 10, new InstanceGuard());

// The properties that are being visited and change here are:
// 1. 'TestString1' property of Parent objects, anywhere in Parent's hierarchy
// 2. 'TestDate1' property of Child objects, anywhere in Parent's hierarchy
// 3.  Any property of type CommonType, anywhere in Parent's hierarchy

//Property setter: new value for property 'TestString1' is set by compiled expression '(old, met) => old + met'
//'old' is old value, 'met' is metadata obj. coming from [VisitorMetadata] attribute on 'TestString1' property.

There is also an option of ManualWaler for building more specific visitor that will visit only nodes in specific place in object graph (e.g. only a 'Child' element at level 3 and only it's 'TestString1' property).

Many thanks to Francisco José Rey Gozalo for contributing with ideas and solutions.

There is a newer version of this package available.
See the version list below for details.
Install-Package ExpressWalker -Version
dotnet add package ExpressWalker --version
<PackageReference Include="ExpressWalker" Version="" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ExpressWalker --version
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: ExpressWalker,"
For F# scripts that support #r syntax, copy this into the source code to reference the package.

Release Notes

Initial stable version


This package has 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 History

Version Downloads Last updated 672 4/1/2018 618 9/10/2016 571 9/8/2016 570 9/7/2016 569 9/7/2016 576 8/17/2016 564 8/17/2016 590 8/16/2016 570 8/16/2016 569 8/9/2016 596 8/7/2016 550 8/7/2016 570 8/7/2016 555 8/7/2016 565 8/4/2016 587 8/3/2016 583 8/3/2016 595 8/3/2016 581 8/3/2016
Show less