Bagikan melalui


Atribut yang Mengontrol Serialisasi XML

Anda dapat menerapkan atribut yang ada di tabel berikut pada kelas dan anggota kelas untuk mengendalikan cara XmlSerializer melakukan serialisasi atau deserialisasi terhadap sebuah instance dari kelas tersebut. Untuk memahami bagaimana atribut ini mengontrol serialisasi XML, lihat Mengontrol Serialisasi XML Menggunakan Atribut.

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

Untuk informasi selengkapnya tentang atribut, lihat Atribut.

Karakteristik Berlaku pada Menetapkan
XmlAnyAttributeAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan sebuah array objek XmlAttribute. Saat deserialisasi, array akan diisi dengan XmlAttribute objek yang mewakili semua atribut XML yang tidak diketahui oleh skema.
XmlAnyElementAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan sebuah array objek XmlElement. Saat deserialisasi, array diisi dengan XmlElement objek yang mewakili semua elemen XML yang tidak diketahui oleh skema.
XmlArrayAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan array objek kompleks. Anggota array akan dihasilkan sebagai anggota array XML.
XmlArrayItemAttribute Bidang publik, properti, parameter, atau nilai pengembalian yang mengembalikan array objek kompleks. Jenis turunan yang dapat dimasukkan ke dalam array. Biasanya diterapkan bersama dengan XmlArrayAttribute.
XmlAttributeAttribute Bidang publik, properti, parameter, atau nilai pengembalian. Anggota akan diserialisasikan sebagai atribut XML.
XmlChoiceIdentifierAttribute Bidang publik, properti, parameter, atau nilai pengembalian. Anggota dapat dibedakan lebih lanjut dengan menggunakan enumerasi.
XmlElementAttribute Bidang publik, properti, parameter, atau nilai pengembalian. Bidang atau properti akan diserialisasikan sebagai elemen XML.
XmlEnumAttribute Bidang publik yang berfungsi sebagai pengidentifikasi jumlah. Nama elemen anggota enumerasi.
XmlIgnoreAttribute Properti dan bidang publik. Properti atau field harus diabaikan saat kelas induk diserialisasi.
XmlIncludeAttribute Deklarasi kelas turunan publik, dan mengembalikan nilai metode publik untuk dokumen Web Services Description Language (WSDL). Kelas harus disertakan saat membuat skema (untuk dikenali saat diserialisasikan).
XmlRootAttribute Deklarasi kelas publik. Mengontrol serialisasi XML dari target atribut sebagai elemen akar XML. Gunakan atribut untuk lebih lanjut menentukan nama ruang lingkup dan nama elemen.
XmlTextAttribute Properti dan bidang publik. Properti atau bidang harus diserialisasikan sebagai teks XML.
XmlTypeAttribute Deklarasi kelas publik. Nama dan namespace tipe XML.
ObsoleteAttribute Properti dan bidang publik. Properti atau bidang akan diabaikan ketika kelas yang memuatnya diserialisasi.

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

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

Lihat juga