XmlConvert Kelas

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlConvert.cs

Mengodekan dan mendekode nama XML, dan menyediakan metode untuk mengonversi antara jenis runtime bahasa umum dan jenis bahasa definisi Skema XML (XSD). Saat mengonversi jenis data, nilai yang dikembalikan tidak bergantung pada lokal.

public ref class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Warisan

Object

XmlConvert

Keterangan

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.

Pengkodean dan penguraian kode

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	Description
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).

Konstruktor

Nama	Deskripsi
XmlConvert()	Menginisialisasi instans baru dari kelas XmlConvert.

Metode

Nama	Deskripsi
DecodeName(String)	Mendekode nama. Metode ini melakukan kebalikan dari EncodeName(String) metode dan EncodeLocalName(String) .
EncodeLocalName(String)	Mengonversi nama menjadi nama lokal XML yang valid.
EncodeName(String)	Mengonversi nama menjadi nama XML yang valid.
EncodeNmToken(String)	Memverifikasi nama tersebut valid sesuai dengan spesifikasi XML.
IsNCNameChar(Char)	Memeriksa apakah karakter yang diteruskan adalah jenis karakter non-titik dua yang valid.
IsPublicIdChar(Char)	Mengembalikan instans karakter yang diteruskan jika karakter dalam argumen adalah karakter id publik yang valid, jika tidak null.
IsStartNCNameChar(Char)	Memeriksa apakah karakter yang diteruskan adalah jenis Karakter Nama Mulai yang valid.
IsWhitespaceChar(Char)	Memeriksa apakah karakter yang diteruskan adalah karakter spasi kosong XML yang valid.
IsXmlChar(Char)	Memeriksa apakah karakter yang diteruskan adalah karakter XML yang valid.
IsXmlSurrogatePair(Char, Char)	Memeriksa apakah pasangan pengganti karakter yang diteruskan adalah karakter XML yang valid.
ToBoolean(String)	Mengonversi menjadi StringBoolean setara.
ToByte(String)	Mengonversi menjadi StringByte setara.
ToChar(String)	Mengonversi menjadi StringChar setara.
ToDateTime(String, String)	Mengonversi menjadi StringDateTime setara.
ToDateTime(String, String[])	Mengonversi menjadi StringDateTime setara.
ToDateTime(String, XmlDateTimeSerializationMode)	Mengonversi ke StringDateTime menggunakan yang XmlDateTimeSerializationMode ditentukan.
ToDateTime(String)	Kedaluwarsa. Mengonversi menjadi StringDateTime setara.
ToDateTimeOffset(String, String)	Mengonversi yang disediakan String menjadi DateTimeOffset setara.
ToDateTimeOffset(String, String[])	Mengonversi yang disediakan String menjadi DateTimeOffset setara.
ToDateTimeOffset(String)	Mengonversi yang disediakan String menjadi DateTimeOffset setara.
ToDecimal(String)	Mengonversi menjadi StringDecimal setara.
ToDouble(String)	Mengonversi menjadi StringDouble setara.
ToGuid(String)	Mengonversi menjadi StringGuid setara.
ToInt16(String)	Mengonversi menjadi StringInt16 setara.
ToInt32(String)	Mengonversi menjadi StringInt32 setara.
ToInt64(String)	Mengonversi menjadi StringInt64 setara.
ToSByte(String)	Mengonversi menjadi StringSByte setara.
ToSingle(String)	Mengonversi menjadi StringSingle setara.
ToString(Boolean)	Mengonversi ke BooleanString.
ToString(Byte)	Mengonversi ke ByteString.
ToString(Char)	Mengonversi ke CharString.
ToString(DateTime, String)	Mengonversi ke DateTimeString.
ToString(DateTime, XmlDateTimeSerializationMode)	Mengonversi ke DateTimeString menggunakan yang XmlDateTimeSerializationMode ditentukan.
ToString(DateTime)	Kedaluwarsa. Mengonversi ke DateTimeString.
ToString(DateTimeOffset, String)	Mengonversi yang disediakan DateTimeOffset ke String dalam format yang ditentukan.
ToString(DateTimeOffset)	Mengonversi yang disediakan DateTimeOffset ke String.
ToString(Decimal)	Mengonversi ke DecimalString.
ToString(Double)	Mengonversi ke DoubleString.
ToString(Guid)	Mengonversi ke GuidString.
ToString(Int16)	Mengonversi ke Int16String.
ToString(Int32)	Mengonversi ke Int32String.
ToString(Int64)	Mengonversi ke Int64String.
ToString(SByte)	Mengonversi ke SByteString.
ToString(Single)	Mengonversi ke SingleString.
ToString(TimeSpan)	Mengonversi ke TimeSpanString.
ToString(UInt16)	Mengonversi ke UInt16String.
ToString(UInt32)	Mengonversi ke UInt32String.
ToString(UInt64)	Mengonversi ke UInt64String.
ToTimeSpan(String)	Mengonversi menjadi StringTimeSpan setara.
ToUInt16(String)	Mengonversi menjadi StringUInt16 setara.
ToUInt32(String)	Mengonversi menjadi StringUInt32 setara.
ToUInt64(String)	Mengonversi menjadi StringUInt64 setara.
VerifyName(String)	Memverifikasi bahwa nama tersebut adalah nama yang valid sesuai dengan rekomendasi W3C Extended Markup Language.
VerifyNCName(String)	Memverifikasi bahwa nama tersebut valid NCName sesuai dengan rekomendasi W3C Extended Markup Language. NCName Adalah nama yang tidak boleh berisi titik dua.
VerifyNMTOKEN(String)	Memverifikasi bahwa string adalah NMTOKEN yang valid sesuai dengan rekomendasi W3C XML Schema Part2: Datatypes.
VerifyPublicId(String)	Mengembalikan instans string yang diteruskan jika semua karakter dalam argumen string adalah karakter id publik yang valid.
VerifyTOKEN(String)	Memverifikasi bahwa string adalah token yang valid sesuai dengan rekomendasi W3C XML Schema Part2: Datatypes.
VerifyWhitespace(String)	Mengembalikan instans string yang diteruskan jika semua karakter dalam argumen string adalah karakter spasi kosong yang valid.
VerifyXmlChars(String)	Mengembalikan string yang diteruskan jika semua karakter dan karakter pasangan pengganti dalam argumen string adalah karakter XML yang XmlException valid, jika tidak, dilemparkan dengan informasi pada karakter pertama yang tidak valid yang ditemui.