.NET 9 WinForms升级后WFO1000错误：如何正确配置序列化？

WFO1000错误是.NET 9对WinForms控件属性序列化新增的安全检查，要求必须明确配置属性的代码序列化规则，避免潜在的反序列化安全风险。以下是不同场景下的具体解决方法：

场景1：简单类型属性（如string、int、bool）需要设计器序列化 #

如果属性是值类型或可直接序列化的简单引用类型，且希望设计器将其值写入.Designer.cs文件，直接添加[DesignerSerializationVisibility]标记为Visible即可：

using System.ComponentModel;

// 确保属性有公有的get/set方法，设计器才能序列化
[Browsable(true)] // 可选，默认属性是可浏览的
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
[DefaultValue("默认文本")] // 可选，当值等于默认值时不生成序列化代码
public string MyCustomProperty { get; set; } = "默认文本";

场景2：复杂类型属性（自定义类/结构体） #

对于自定义类型的属性，需要为类型添加序列化支持，通常有两种方式：

方式A：使用TypeConverter实现字符串序列化 #

为自定义类编写TypeConverter，实现类型与字符串的双向转换，让设计器能通过字符串序列化属性值：

using System.ComponentModel;
using System.Globalization;

// 给自定义类型添加TypeConverter标记
[TypeConverter(typeof(UserInfoConverter))]
public class UserInfo
{
    public string Username { get; set; }
    public int Age { get; set; }
}

// 自定义TypeConverter
public class UserInfoConverter : TypeConverter
{
    // 支持从字符串转换为UserInfo
    public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
    {
        return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
    }

    public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
    {
        if (value is string strValue && !string.IsNullOrEmpty(strValue))
        {
            var parts = strValue.Split('|');
            if (parts.Length == 2 && int.TryParse(parts[1], out int age))
            {
                return new UserInfo
                {
                    Username = parts[0],
                    Age = age
                };
            }
        }
        return base.ConvertFrom(context, culture, value);
    }

    // 支持从UserInfo转换为字符串
    public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
    {
        if (destinationType == typeof(string) && value is UserInfo user)
        {
            return $"{user.Username}|{user.Age}";
        }
        return base.ConvertTo(context, culture, value, destinationType);
    }
}

然后在用户控件的属性上添加序列化标记：

[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
public UserInfo CurrentUser { get; set; } = new UserInfo();

方式B：实现ISerializable接口（适用于更复杂的类型） #

如果自定义类型需要完整的对象序列化，可实现ISerializable接口，手动控制序列化和反序列化逻辑：

using System.Runtime.Serialization;

[Serializable]
public class OrderInfo : ISerializable
{
    public string OrderId { get; set; }
    public decimal Amount { get; set; }

    public OrderInfo() { }

    // 反序列化构造函数
    protected OrderInfo(SerializationInfo info, StreamingContext context)
    {
        OrderId = info.GetString(nameof(OrderId));
        Amount = info.GetDecimal(nameof(Amount));
    }

    // 序列化逻辑
    public void GetObjectData(SerializationInfo info, StreamingContext context)
    {
        info.AddValue(nameof(OrderId), OrderId);
        info.AddValue(nameof(Amount), Amount);
    }
}

同样在属性上添加Visible标记即可。

场景3：集合类型属性（如List、BindingList） #

集合属性需要用DesignerSerializationVisibility.Content标记，让设计器序列化集合的内容而非集合本身：

using System.ComponentModel;
using System.Collections.Generic;

[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
public List<string> TagList { get; } = new List<string>();

注意：集合属性建议使用只读的自动属性（只保留getter），避免设计器重复创建集合实例。

场景4：属性仅在运行时使用，不需要序列化 #

如果属性不需要被设计器序列化（比如仅运行时赋值），直接标记为Hidden即可：

using System.ComponentModel;

[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public int RuntimeStatus { get; set; }

关键注意事项 #

• 确保属性的setter是公有的（如果需要设计器序列化），私有的setter会导致设计器无法写入值。
• 结合[DefaultValue]属性可以减少.Designer.cs中的冗余代码，当属性值等于默认值时，设计器不会生成序列化代码。

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