foreach (var change in report.Changes)
{
Console.WriteLine($"{change.ChangeType}: {change.Path}");
if (change.PropertyChanges is null)
continue;
foreach (var prop in change.PropertyChanges)
Console.WriteLine($" - {prop.PropertyName}: '{prop.OldValue}' -> '{prop.NewValue}'");
}
What the report contains
SyncReport.Changes contains ChangeRecord entries:
ChangeType: Added, Updated, or Removed
Path: a stable-ish path for the item (supports nesting)
Item: the destination item instance
PropertyChanges: only present for Updated
FAQ
How are item paths created?
Paths look like Person[1] and Person[1].Cat[3].
The [...] value is chosen by looking for a public readable ID or Id property on either the source or destination item. If neither exists, it becomes ?.
What counts as an update?
After your mapProperties delegate runs, CollectionMerger snapshots public instance scalar properties (excluding enumerables except string) and records an Updated change if any of those values differ.
Are collections compared automatically?
No. Collection properties are ignored for property change detection.
If you want nested changes, perform nested merges with the nested overload of MapFrom(...).
What are the requirements?
Destination must be an ICollection<TDestination>
TDestination must have a parameterless constructor (new() constraint)
Matching behavior is entirely defined by your matchPredicate (make sure it uniquely identifies items)
