Bagikan melalui


Antarmuka System.Runtime.Serialization.IExtensibleDataObject

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

Antarmuka IExtensibleDataObject menyediakan satu properti yang mengatur atau mengembalikan struktur yang digunakan untuk menyimpan data yang berada di luar kontrak data. Data tambahan disimpan dalam instans ExtensionDataObject kelas dan diakses melalui ExtensionData properti . Dalam operasi pulang-pergi di mana data diterima, diproses, dan dikirim kembali, data tambahan dikirim kembali ke pengirim asli secara utuh. Ini berguna untuk menyimpan data yang diterima dari versi kontrak mendatang. Jika Anda tidak menerapkan antarmuka, data tambahan diabaikan dan dibuang selama operasi pulang pergi.

Untuk menggunakan fitur penerapan versi ini

  1. Terapkan IExtensibleDataObject antarmuka di kelas .

  2. Tambahkan properti ke ExtensionData jenis Anda.

  3. Tambahkan anggota privat jenis ExtensionDataObject ke kelas .

  4. Terapkan metode dapatkan dan atur untuk properti menggunakan anggota privat baru.

  5. Terapkan DataContractAttribute atribut ke kelas . Atur Name properti dan Namespace ke nilai yang sesuai jika perlu.

Untuk informasi selengkapnya tentang penerapan versi jenis, lihat Penerapan Versi Kontrak Data. Untuk informasi tentang membuat kontrak data yang kompatibel dengan penerusan, lihat Kontrak Data yang Kompatibel Maju. Untuk informasi selengkapnya tentang kontrak data, lihat Menggunakan Kontrak Data.