System.Runtime.Serialization.IExtensibleDataObject 接口

本文提供了此 API 参考文档的补充说明。

IExtensibleDataObject 接口提供了单个属性，该属性设置或返回一个用于存储数据协定外部数据的结构。 额外数据存储在 ExtensionDataObject 类的实例中，并且通过 ExtensionData 属性访问。 在接收、处理和返回数据的往返操作中，额外数据被原封不动地返回到原始发送方。 这可用于存储从协定的将来版本接收的数据。 如果您没有实现该接口，则会在往返操作中忽略和丢弃任何额外数据。

使用此版本管理功能

1. 在类中实现 IExtensibleDataObject 接口。

2. 将 ExtensionData 属性添加到您的类型中。

3. 将类型 ExtensionDataObject 的一个私有成员添加到该类中。

4. 使用新的私有成员为该属性实现 get 和 set 方法。

5. 将 DataContractAttribute 属性应用于该类。 如有必要，将 Name 和 Namespace 属性设置为适当的值。

有关类型版本控制的详细信息，请参阅 数据协定版本控制。 有关创建与转发兼容的数据协定的信息，请参阅 向前兼容的数据协定。 有关数据协定的详细信息，请参阅使用数据协定。