如何在.NET MAUI中安全实现对象深浅拷贝？控件拷贝报错求解

一、原代码抛出System.NotImplementedException的原因 #

你用System.Text.Json序列化实现深拷贝的方式，无法处理MAUI控件（甚至部分复杂自定义对象）：MAUI控件继承的VisualElement等基类未标记可序列化，且包含大量平台原生引用、未实现序列化逻辑的成员，序列化过程中会触发未实现的方法，最终抛出异常。

二、安全实现任意对象的浅拷贝与深拷贝 #

1. 浅拷贝优化 #

你的浅拷贝逻辑可行，但可以泛型化并增加异常处理，提升类型安全性：

public static T ShallowCopy<T>(T source) where T : class
{
    if (source == null) return null;
    try
    {
        var cloneMethod = typeof(T).GetMethod("MemberwiseClone", BindingFlags.Instance | BindingFlags.NonPublic);
        return cloneMethod?.Invoke(source, null) as T;
    }
    catch (Exception ex)
    {
        throw new InvalidOperationException($"无法创建{typeof(T)}的浅拷贝", ex);
    }
}

注意事项：

• 浅拷贝仅复制值类型成员，引用类型成员仅复制引用，原对象与拷贝对象会共享同一引用实例
• 值类型（struct）可直接用=赋值完成拷贝，无需反射

2. 深拷贝的可靠实现方案 #

方案1：递归反射拷贝（适合自定义业务对象）

通过反射遍历对象所有成员，递归复制值类型和引用类型，可处理大多数业务对象：

private static readonly Dictionary<object, object> _copiedObjects = new();

public static T DeepCopy<T>(T source)
{
    if (source == null) return default;
    if (_copiedObjects.TryGetValue(source, out var existingCopy))
    {
        return (T)existingCopy;
    }

    var type = source.GetType();

    // 处理值类型和字符串
    if (type.IsValueType || type == typeof(string))
    {
        return source;
    }

    // 处理数组
    if (type.IsArray)
    {
        var elementType = Type.GetType(type.FullName.Replace("[]", string.Empty));
        var array = source as Array;
        var copiedArray = Array.CreateInstance(elementType, array.Length);
        _copiedObjects.Add(source, copiedArray);
        for (int i = 0; i < array.Length; i++)
        {
            copiedArray.SetValue(DeepCopy(array.GetValue(i)), i);
        }
        return (T)(object)copiedArray;
    }

    // 处理引用类型
    var instance = Activator.CreateInstance(type);
    _copiedObjects.Add(source, instance);

    // 复制字段
    foreach (var field in type.GetFields(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic))
    {
        var value = field.GetValue(source);
        field.SetValue(instance, DeepCopy(value));
    }

    // 复制可读写属性
    foreach (var property in type.GetProperties(BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic)
                                 .Where(p => p.CanRead && p.CanWrite))
    {
        var value = property.GetValue(source);
        property.SetValue(instance, DeepCopy(value));
    }

    _copiedObjects.Remove(source);
    return (T)instance;
}

优化点：加入字典记录已拷贝对象，避免循环引用导致的无限递归。

方案2：改进版Json序列化（仅适合无循环引用的业务对象）

如果坚持用Json序列化，需配置忽略循环引用和只读属性，避免序列化失败：

public static T DeepCopyJson<T>(T source)
{
    if (source == null) return default;
    var options = new JsonSerializerOptions
    {
        Converters = { new JsonStringEnumConverter() },
        ReferenceHandler = ReferenceHandler.IgnoreCycles,
        IgnoreReadOnlyProperties = true
    };
    try
    {
        var json = JsonSerializer.Serialize(source, options);
        return JsonSerializer.Deserialize<T>(json, options);
    }
    catch (Exception ex)
    {
        throw new InvalidOperationException("Json深拷贝失败", ex);
    }
}

局限性：仍无法拷贝MAUI控件，仅适用于简单业务对象。

三、完整拷贝MAUI控件 #

MAUI控件包含可视化状态、平台原生引用、事件绑定等复杂内容，无法通过通用拷贝方法复制，必须手动重建控件实例并复制核心属性。

通用控件拷贝示例 #

public static T CloneControl<T>(T original) where T : VisualElement, new()
{
    if (original == null) return default;

    var cloned = new T();

    // 复制VisualElement通用属性
    cloned.BackgroundColor = original.BackgroundColor;
    cloned.WidthRequest = original.WidthRequest;
    cloned.HeightRequest = original.HeightRequest;
    cloned.Margin = original.Margin;
    cloned.Padding = original.Padding;
    cloned.HorizontalOptions = original.HorizontalOptions;
    cloned.VerticalOptions = original.VerticalOptions;
    cloned.IsVisible = original.IsVisible;
    cloned.IsEnabled = original.IsEnabled;
    cloned.Rotation = original.Rotation;
    cloned.Scale = original.Scale;

    // 复制特定控件属性（以Label为例）
    if (original is Label originalLabel && cloned is Label clonedLabel)
    {
        clonedLabel.Text = originalLabel.Text;
        clonedLabel.TextColor = originalLabel.TextColor;
        clonedLabel.FontSize = originalLabel.FontSize;
        clonedLabel.FontAttributes = originalLabel.FontAttributes;
        clonedLabel.HorizontalTextAlignment = originalLabel.HorizontalTextAlignment;
    }

    // 复制布局控件的子元素（递归拷贝）
    if (original is Layout originalLayout && cloned is Layout clonedLayout)
    {
        foreach (var child in originalLayout.Children)
        {
            var clonedChild = CloneControl(child);
            clonedLayout.Children.Add(clonedChild);
        }
    }

    // 复制绑定上下文
    cloned.BindingContext = original.BindingContext;

    // 复制事件（仅支持公共委托，匿名委托无法复制）
    if (original is Button originalBtn && cloned is Button clonedBtn)
    {
        var clickEvent = typeof(Button).GetEvent(nameof(Button.Clicked));
        var handler = clickEvent.GetValue(originalBtn);
        if (handler != null)
        {
            clickEvent.AddEventHandler(clonedBtn, handler);
        }
    }

    return cloned;
}

控件拷贝注意事项：

• 匿名委托、Lambda表达式无法直接复制，需手动重新绑定
• 平台特定属性（如iOS专属的ContentMode）需单独处理
• 资源引用（图片、样式）会自动共享，无需额外复制

总结 #

• 业务对象：浅拷贝用MemberwiseClone反射实现，深拷贝优先选择递归反射（支持循环引用）或改进后的Json序列化
• MAUI控件：必须手动重建实例，逐个复制属性、子元素和可复用的事件绑定

内容的提问来源于stack exchange，提问作者incidious works