Deep Clone

Basic usage#

using CloneBox;

var customer = new Customer {
    Id = 1,
    Name = "Ada",
    Address = new Address { City = "Berlin" }
};

var copy = customer.CloneX();

Or with explicit settings:

var copy = customer.CloneX(new CloneSettings {
    IncludeNonPublicFields = false,
    IncludeNonPublicProperties = false
});

What is copied#

By default CloneBox copies public and non-public properties and fields, and will use non-public constructors when needed:

• Nested objects and inheritance hierarchies
• Lists and arrays (including multi-dimensional and non-zero-based)
• Dictionaries with their runtime key types
• Structs and built-in types
• Graphs with self-references and cycles

The result is a new graph. Mutating copy does not change customer, and nested objects are not shared.

Cycles#

CloneBox tracks objects it has already cloned. If A points to B and B points back to A, the clone preserves that shape instead of recursing forever.

var root = new Node();
root.Self = root;

var clone = root.CloneX();
// clone is a new instance; clone.Self == clone

Optional settings#

Pass a CloneSettings instance to control visibility, ICloneable, skip predicates, and logging. Defaults are intentionally broad so a typical deep clone “just works”.