Atribut yang Mengontrol Serialisasi XML

  • Artikel

Anda bisa menerapkan atribut dalam tabel berikut ke kelas-kelas dan anggota-anggota kelas untuk mengontrol cara XmlSerializer melakukan serialisasi atau deserialisasi instans kelas. Untuk memahami cara atribut-atribut ini mengontrol serialisasi XML, lihat Mengontrol Serialisasi XML Menggunakan Atribut.

Atribut ini juga bisa digunakan untuk mengontrol pesan SOAP gaya harfiah yang dihasilkan oleh layanan Web XML. Untuk informasi selengkapnya tentang penerapan atribut ini ke metode layanan Web XML, lihat Serialisasi XML dengan Layanan Web XML.

Untuk informasi selengkapnya tentang atribut, lihat Atribut.

Atribut Berlaku untuk Menentukan
XmlAnyAttributeAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan larik dari objek-objek XmlAttribute. Saat melakukan deserialisasi, larik akan diisi dengan objek-objek XmlAttribute yang mewakili semua atribut XML yang tidak diketahui oleh skema.
XmlAnyElementAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan larik dari objek-objek XmlElement. Saat melakukan deserialisasi, larik akan diisi dengan objek-objek XmlElement yang mewakili semua elemen XML yang tidak diketahui oleh skema.
XmlArrayAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan larik dari objek-objek yang kompleks. Anggota larik akan dihasilkan sebagai anggota larik XML.
XmlArrayItemAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan larik dari objek-objek yang kompleks. Jenis-jenis turunan yang bisa disisipkan ke dalam larik. Biasanya diterapkan bersamaan dengan XmlArrayAttribute.
XmlAttributeAttribute Bidang publik, properti, parameter, atau nilai yang dikembalikan. Anggota akan diserialisasikan sebagai atribut XML.
XmlChoiceIdentifierAttribute Bidang publik, properti, parameter, atau nilai yang dikembalikan. Anggota bisa dibedakan lebih lanjut dengan menggunakan sebuah enumerasi.
XmlElementAttribute Bidang publik, properti, parameter, atau nilai yang dikembalikan. Bidang atau properti akan diserialisasikan sebagai elemen XML.
XmlEnumAttribute Bidang publik yang merupakan pengidentifikasi enumerasi. Nama elemen dari anggota enumerasi.
XmlIgnoreAttribute Properti serta bidang publik. Properti atau bidang harus diabaikan ketika kelas yang memuat diserialisasikan.
XmlIncludeAttribute Deklarasi kelas turunan publik, serta nilai pengembalian dari metode publik untuk dokumen Bahasa Deskripsi Layanan Web (WSDL). Kelas harus disertakan saat membuat skema (untuk dikenali saat dilakukan serialisasi).
XmlRootAttribute Deklarasi kelas publik. Mengontrol serialisasi XML dari target atribut sebagai sebuah elemen akar XML. Gunakan atribut untuk menentukan kumpulan nama XML serta nama elemen lebih lanjut.
XmlTextAttribute Properti serta bidang publik. Properti atau bidang harus dilakukan serialisasi sebagai teks XML.
XmlTypeAttribute Deklarasi kelas publik. Nama serta kumpulan nama XML dari jenis XML.
ObsoleteAttribute Properti serta bidang publik. Properti atau bidang akan diabaikan ketika kelas yang berisi diserialisasikan.

Selain atribut ini, yang semuanya ditemukan pada kumpulan nama XML System.Xml.Serialization, Anda juga dapat menerapkan atribut DefaultValueAttribute ke sebuah bidang. DefaultValueAttribute menetapkan nilai yang akan ditetapkan ke anggota secara otomatis jika tidak ada nilai yang ditentukan.

Untuk mengontrol serialisasi SOAP XML yang dikodekan, lihat Atribut yang Mengontrol Serialisasi SOAP yang Dikodekan.

Lihat juga