C#的DataContractSerializer怎么用 WCF数据序列化

在WCF服务开发中，DataContractSerializer是官方推荐的序列化组件，负责将内存中的对象转换为可传输的XML格式，同时也能将接收到的XML数据还原为对应的对象实例，是WCF实现跨进程、跨网络数据交互的基础支撑。

DataContractSerializer使用前提

要使用DataContractSerializer序列化自定义类型的对象，需要给对应的类添加DataContractAttribute特性，给需要序列化的成员添加DataMemberAttribute特性，这两个特性都位于System.Runtime.Serialization命名空间下。

需要注意的是，没有标记DataMemberAttribute的成员不会被序列化，这和SerializableAttribute的默认全成员序列化逻辑不同。另外，类的构造函数不需要额外标记特性，序列化过程会直接处理公共属性和字段。

示例类定义

using System.Runtime.Serialization;

[DataContract]
public class UserInfo
{
    [DataMember]
    public int UserId { get; set; }

    [DataMember]
    public string UserName { get; set; }

    // 该成员没有标记DataMember，不会被序列化
    public string Password { get; set; }

    [DataMember]
    public DateTime RegisterTime { get; set; }
}

序列化操作实现

序列化过程需要创建DataContractSerializer实例，指定要序列化的对象类型，然后使用WriteObject方法将对象写入流中。通常使用MemoryStream作为中间流，方便后续获取序列化后的字符串。

序列化代码示例

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Text;

public class SerializerDemo
{
    public static string SerializeUserInfo(UserInfo user)
    {
        // 创建序列化器，指定要序列化的类型
        DataContractSerializer serializer = new DataContractSerializer(typeof(UserInfo));
        // 创建内存流存储序列化结果
        using (MemoryStream ms = new MemoryStream())
        {
            // 执行序列化，将对象写入流
            serializer.WriteObject(ms, user);
            // 将流中的字节转换为字符串
            byte[] data = ms.ToArray();
            return Encoding.UTF8.GetString(data);
        }
    }
}

// 调用示例
class Program
{
    static void Main()
    {
        UserInfo user = new UserInfo
        {
            UserId = 1,
            UserName = "张三",
            Password = "123456",
            RegisterTime = DateTime.Now
        };
        string xmlResult = SerializerDemo.SerializeUserInfo(user);
        Console.WriteLine(xmlResult);
    }
}

上述代码执行后，输出的XML结果中不会包含Password字段的内容，符合特性标记的预期效果。

反序列化操作实现

反序列化和序列化过程对应，使用ReadObject方法从流中读取数据并还原为对象实例，需要将返回值转换为对应的类型。

反序列化代码示例

using System;
using System.IO;
using System.Runtime.Serialization;
using System.Text;

public class SerializerDemo
{
    public static UserInfo DeserializeUserInfo(string xmlData)
    {
        DataContractSerializer serializer = new DataContractSerializer(typeof(UserInfo));
        using (MemoryStream ms = new MemoryStream(Encoding.UTF8.GetBytes(xmlData)))
        {
            // 执行反序列化，转换返回结果为UserInfo类型
            return (UserInfo)serializer.ReadObject(ms);
        }
    }
}

// 调用示例
class Program
{
    static void Main()
    {
        string xml = "<?xml version="1.0" encoding="utf-8"?><UserInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/"><RegisterTime>2024-05-20T10:30:00</RegisterTime><UserId>1</UserId><UserName>张三</UserName></UserInfo>";
        UserInfo user = SerializerDemo.DeserializeUserInfo(xml);
        Console.WriteLine($"用户ID：{user.UserId}，用户名：{user.UserName}");
    }
}

WCF中的默认应用

在WCF服务中，如果服务契约的数据契约类正确标记了DataContract和DataMember特性，WCF会默认使用DataContractSerializer处理参数的序列化和反序列化，不需要开发者手动编写序列化代码。

如果需要自定义序列化行为，也可以在服务契约的操作契约中通过特性指定序列化器，或者修改服务的配置来替换默认的序列化组件，不过绝大多数场景下使用默认的DataContractSerializer就能满足需求。

使用注意事项

• 被序列化的类必须有一个无参构造函数，不管是公共的还是私有的，否则反序列化时会抛出异常。
• 如果需要序列化循环引用的对象，需要给DataContractSerializer的构造函数传入preserveObjectReferences参数为true，否则会抛出循环引用异常。
• 和XmlSerializer相比，DataContractSerializer的性能更高，但是对XML格式的控制能力更弱，如果需要严格遵循指定的XML格式，可能需要选择其他序列化工具。
• 标记DataMember的成员顺序不会影响序列化结果的正确性，但是如果需要和旧版本的数据兼容，可以通过Order属性指定成员的序列化顺序。

DataContractSerializerWCF数据序列化C_Sharp修改时间：2026-07-16 01:57:28