共用方式為

System.Runtime.Serialization.IExtensibleDataObject 介面

  • 發行項

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

IExtensibleDataObject 介面會提供單一屬性，這個屬性可設定或傳回用來儲存資料合約外部資料的結構。 額外資料會儲存在 ExtensionDataObject 類別的執行個體，並且會透過 ExtensionData 屬性來存取。 透過資料進行接收、處理以及傳回的來回作業，額外資料會原封不動地傳回原始的傳送者。 這種方式可以用來儲存接收自合約未來版本的資料。 如果您不實作這個介面，任何額外的資料都會在來回作業期間遭到忽略並且捨棄。

為了使用這個版本控制功能，此時要

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

  2. 將 ExtensionData 屬性新增至型別。

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

  4. 使用新的私用成員來實作屬性的取得與設定方法。

  5. 將 DataContractAttribute 屬性套用至該類別。 將 Name 和 Namespace 屬性設定為適當的值 (如有必要)。

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