Kelas System.Xml.XmlConvert

Nota

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

Kelas XmlConvert secara fungsional setara dengan kelas Convert, tetapi mendukung standar XML. Sistem jenis didasarkan pada jenis skema bahasa definisi Skema XML (XSD), dan nilai yang dikembalikan selalu independen lokal.

Pengodean dan pendekodean

Nama elemen dan atribut atau nilai ID terbatas pada rentang karakter XML sesuai dengan rekomendasi W3C XML 1.0. Ketika nama berisi karakter yang tidak valid, Anda dapat menggunakan EncodeName metode dan DecodeName di kelas ini untuk menerjemahkannya ke dalam nama XML yang valid.

Misalnya, jika Anda ingin menggunakan judul kolom "Detail Pesanan" dalam database, database memungkinkan ruang di antara dua kata. Namun, dalam XML, spasi antara "Order" dan "Detail" dianggap sebagai karakter XML yang tidak valid. Anda harus mengonversinya menjadi pengodean heksadesimal ter-escape dan mendekodenya nanti.

Anda dapat menggunakan EncodeName metode dengan XmlWriter kelas untuk memastikan nama yang ditulis adalah nama XML yang valid. Kode C# berikut mengonversi nama "Order Detail" menjadi nama XML yang valid dan menulis elemen <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

Berikut adalah metode XmlConvert yang melakukan pengodean dan decoding.

Metode	Deskripsi
EncodeName	Mengambil nama dan mengembalikan nama yang telah dikodekan serta karakter tidak valid yang digantikan oleh string pelolosan. Metode ini memungkinkan titik dua berada dalam posisi apa pun, yang berarti bahwa nama mungkin masih tidak valid sesuai dengan rekomendasi Namespace di XML 1.0 W3C.
EncodeNmToken	Mengambil nama dan mengembalikan nama yang dikodekan.
EncodeLocalName	Sama seperti EncodeName kecuali juga mengodekan karakter titik dua, menjamin bahwa nama dapat digunakan sebagai LocalName bagian dari nama yang memenuhi syarat namespace.
DecodeName	Membalikkan transformasi untuk semua metode pengodean.

Validasi nama

Kelas XmlConvert berisi dua metode yang memeriksa karakter dalam elemen atau nama atribut dan memverifikasi bahwa nama sesuai dengan aturan yang ditetapkan oleh rekomendasi W3C XML 1.0:

• VerifyName memeriksa karakter dan memverifikasi bahwa nama tersebut valid. Metode mengembalikan nama jika valid, dan memberikan pengecualian jika tidak.
• VerifyNCName melakukan validasi yang sama, tetapi menerima nama yang tidak memenuhi syarat.

XmlConvert berisi metode tambahan yang memvalidasi token, karakter spasi putih, ID publik, dan string lainnya.

Konversi jenis data

XmlConvert juga menyediakan metode yang memungkinkan Anda mengonversi data dari string ke jenis data bertipe kuat. Misalnya, metode mengonversi ToDateTime string menjadi DateTime setara. Ini berguna karena sebagian besar metode di XmlReader kelas mengembalikan data sebagai string. Setelah data dibaca, data dapat dikonversi ke jenis data yang tepat sebelum digunakan. Overloads ToString menyediakan operasi pelengkap dengan mengonversi data yang bertipe kuat menjadi string. Misalnya, ini berguna saat Anda ingin menambahkan data ke kotak teks di halaman web. Pengaturan lokal tidak diperhitungkan selama konversi data. Jenis data didasarkan pada jenis data Skema XML (XSD).