C#的DataContractSerializer怎么用 WCF数据契约

幻夢星雲
发布: 2025-12-20 04:25:09
原创
823人浏览过
DataContractSerializer 是 WCF 中配合 [DataContract] 和 [DataMember] 特性实现数据序列化与反序列化的核心类,要求显式标记可序列化成员,支持命名空间、顺序、默认值控制及多态扩展。

c#的datacontractserializer怎么用 wcf数据契约

DataContractSerializer 是 WCF 中用于序列化和反序列化数据的核心类,专门配合 [DataContract][DataMember] 特性使用,确保类型能被 WCF 正确传输和解析。

定义可序列化的数据契约

[DataContract] 标记类,用 [DataMember] 标记需要参与序列化的字段或属性。不加 [DataMember] 的成员默认不序列化(包括 public 字段)。

示例:

[DataContract]
public class Person
{
    [DataMember]
    public string Name { get; set; }

    [DataMember]
    public int Age { get; set; }

    // 这个不会被序列化
    public string InternalNote { get; set; }

    // 可选:指定名称、顺序、是否必需、是否应忽略
    [DataMember(Name = "ID", Order = 0, IsRequired = true, EmitDefaultValue = false)]
    public int PersonId { get; set; }
}
登录后复制

用 DataContractSerializer 序列化对象到 XML

创建 DataContractSerializer 实例时传入类型;用 WriteObject 写入流(如 MemoryStream 或文件流)。

秒哒
秒哒

秒哒-不用代码就能实现任意想法

秒哒 584
查看详情 秒哒
  • 必须确保类型已标记 [DataContract],否则抛出异常
  • 推荐显式指定命名空间(如 "http://mycompany.com/person"),避免默认命名空间导致互操作问题
  • 若需格式化输出(带缩进),可传入 XmlWriterSettings
var person = new Person { Name = "Alice", Age = 30, PersonId = 101 };

var serializer = new DataContractSerializer(typeof(Person), 
    new DataContractSerializerSettings { 
        PreserveObjectReferences = true // 如需处理循环引用,设为 true
    });

using var stream = new MemoryStream();
using (var writer = XmlDictionaryWriter.CreateTextWriter(stream, Encoding.UTF8))
{
    serializer.WriteObject(writer, person);
}
string xml = Encoding.UTF8.GetString(stream.ToArray());
登录后复制

从 XML 反序列化回对象

ReadObject 方法从流中读取并还原对象。注意流位置需在开头,且 XML 结构必须与契约严格匹配(命名空间、元素名、嵌套层级)。

  • 如果 XML 含未知元素,默认会跳过;可通过 DataContractSerializerSettings.KnownTypes 添加派生类型支持多态
  • 反序列化失败通常因命名空间不一致、元素名拼写错误或类型不匹配,建议先用 XmlDictionaryReader 检查原始 XML
  • 若服务端返回的是带 Envelope 的 SOAP 响应,不能直接用 DataContractSerializer 解析 —— 它只处理纯数据部分
var xmlBytes = Encoding.UTF8.GetBytes(xml);
using var stream = new MemoryStream(xmlBytes);
using (var reader = XmlDictionaryReader.CreateTextReader(stream, new XmlDictionaryReaderSettings()))
{
    var deserialized = (Person)serializer.ReadObject(reader);
}
登录后复制

常见注意事项

WCF 默认使用 DataContractSerializer,但你也可以在绑定或行为中替换为 XmlSerializer(需手动配置)。实际开发中要注意:

  • [DataMember]EmitDefaultValue 设为 false 可让值为默认值(如 0、null)的字段不出现在 XML 中
  • 集合类型推荐用 List<t></t> 或数组;自定义集合需实现 IList 并标记 [CollectionDataContract]
  • 枚举默认按名称序列化;加 [EnumMember] 可控制别名,或用 [DataContract] + [EnumMember] 禁用未标记项
  • 不要在数据契约中放方法、事件、非公共字段(除非显式标记 [DataMember] 且为 public set)

以上就是C#的DataContractSerializer怎么用 WCF数据契约的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号