System.Runtime.Serialization.IExtensibleDataObject 介面

本文提供此 API 參考文件的補充備註。

介面 IExtensibleDataObject 提供單一屬性，可設定或傳回結構，用來儲存數據合約外部的數據。 額外的數據會儲存在 類別的實例中 ExtensionDataObject ，並透過 ExtensionData 屬性存取。 在接收、處理及傳回數據的往返作業中，額外的數據會完整傳送回原始傳送者。 這適用於儲存從未來合約版本接收的數據。 如果您未實作 介面，則會在往返作業期間忽略和捨棄任何額外的數據。

若要使用此版本管理功能

1. 在 IExtensibleDataObject 類別中實作 介面。

2. 將 ExtensionData 屬性新增至您的類型。

3. 將類型的 ExtensionDataObject 私用成員新增至 類別。

4. 使用新的私用成員來實作屬性的 get 和 set 方法。

5. 將 DataContractAttribute 屬性套用至 類別。 視需要將 Name 和 Namespace 屬性設定為適當的值。

如需類型版本設定的詳細資訊，請參閱 數據合約版本控制。 如需有關建立向前相容數據合約的資訊，請參閱 Forward-Compatible 數據合約。 如需資料合約的詳細資訊，請參閱使用資料合約。