XmlValidatingReader Konstruktor

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Menginisialisasi instans baru dari kelas XmlValidatingReader.

Overload

Nama	Deskripsi
XmlValidatingReader(XmlReader)	Menginisialisasi instans XmlValidatingReader baru kelas yang memvalidasi konten yang dikembalikan dari yang diberikan XmlReader.
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	Menginisialisasi instans XmlValidatingReader baru kelas dengan nilai yang ditentukan.
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	Menginisialisasi instans XmlValidatingReader baru kelas dengan nilai yang ditentukan.

XmlValidatingReader(XmlReader)

Sumber:

XmlValidatingReader.cs

Menginisialisasi instans XmlValidatingReader baru kelas yang memvalidasi konten yang dikembalikan dari yang diberikan XmlReader.

public:
 XmlValidatingReader(System::Xml::XmlReader ^ reader);

public XmlValidatingReader(System.Xml.XmlReader reader);

new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReader

Public Sub New (reader As XmlReader)

Parameter

reader

XmlReader

untuk XmlReader membaca dari saat memvalidasi. Implementasi saat ini hanya XmlTextReadermendukung .

Pengecualian

ArgumentException

Pembaca yang ditentukan bukan .XmlTextReader

Keterangan

Nota

Kelas XmlValidatingReader usang dalam .NET Framework 2.0. Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Semua simpul yang dikembalikan dari yang diberikan XmlReader juga dikembalikan dari pembaca validasi ini, sehingga tidak ada kehilangan informasi dalam prosesnya. Simpul baru yang tidak dikembalikan dari pembaca yang mendasar dapat ditambahkan oleh pembaca ini (misalnya, atribut default dan turunan referensi entitas). Properti apa pun yang diatur pada yang diberikan XmlTextReader juga berlaku untuk pembaca validasi ini. Misalnya, jika pembaca yang disediakan memiliki set WhitespaceHandling.None, pembaca validasi ini juga mengabaikan spasi kosong.

Ketika definisi tipe dokumen eksternal (DTD) atau skema diperlukan untuk validasi, XmlResolver properti mengatur objek yang XmlResolver akan digunakan untuk menyelesaikan sumber daya eksternal.

Lihat juga

• XmlTextReader
• XmlReader

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Sumber:

XmlValidatingReader.cs

Menginisialisasi instans XmlValidatingReader baru kelas dengan nilai yang ditentukan.

public:
 XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

Parameter

xmlFragment

Stream

Aliran yang berisi fragmen XML untuk diurai.

fragType

XmlNodeType

XmlNodeType Fragmen XML. Ini menentukan apa yang dapat dimuat fragmen (lihat tabel di bawah).

context

XmlParserContext

tempat XmlParserContext fragmen XML akan diurai. Ini termasuk XmlNameTable untuk digunakan, pengodean, cakupan namespace, saat ini xml:lang, dan xml:space cakupan.

Pengecualian

XmlException

fragType bukan salah satu jenis node yang tercantum dalam tabel di bawah ini.

Keterangan

Nota

Kelas XmlValidatingReader usang dalam .NET Framework 2.0. Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Konstruktor ini mengurai string yang diberikan sebagai fragmen XML. Jika fragmen XML adalah elemen atau atribut, Anda dapat melewati aturan tingkat akar untuk dokumen XML yang terbentuk dengan baik.

Tabel berikut ini mencantumkan nilai yang valid untuk fragType dan bagaimana pembaca mengurai masing-masing jenis node yang berbeda.

XmlNodeType	Fragmen Mungkin Berisi
Elemen	Konten elemen yang valid (misalnya, kombinasi elemen, komentar, instruksi pemrosesan, cdata, teks, dan referensi entitas apa pun).
Attribute	Nilai atribut (bagian di dalam tanda kutip).
Dokumen	Konten seluruh dokumen XML; ini memberlakukan aturan tingkat dokumen.

Pembaca menggunakan langkah-langkah berikut untuk menentukan pengodean aliran:

1. XmlParserContext.Encoding Memeriksa properti untuk menentukan pengodean.

2. Encoding Jika properti adalah null, pembaca memeriksa tanda urutan byte di awal aliran.

3. Encoding Jika properti adalah null, dan tidak ada tanda urutan byte yang ditemukan, pembaca mengasumsikan aliran dikodekan dalam UTF-8.

Jika pembaca ini akan memvalidasi menggunakan definisi tipe dokumen (DTD) (yaitu, ValidationType diatur ke ValidationType.DTD atau ValidationType.Auto), XmlParserContext yang ditentukan dalam konstruktor harus menyediakan semua informasi DocumentType yang diperlukan.

Nota

Tidak dimungkinkan untuk memvalidasi fragmen dengan menggunakan DTD. Menurut definisi DTD mengharuskan seluruh dokumen dimuat untuk validasi.

Jika pembaca ini akan memvalidasi dengan menggunakan skema XML-Data Reduced (XDR) atau XML Schema definition language (XSD), gunakan Schemas properti untuk menentukan XmlSchemaCollection yang berisi skema (artinya, XmlParserContext tidak perlu menyediakan informasi DocumentType).

Lihat juga

• XmlReader

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Sumber:

XmlValidatingReader.cs

Menginisialisasi instans XmlValidatingReader baru kelas dengan nilai yang ditentukan.

public:
 XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

Parameter

xmlFragment

String

String yang berisi fragmen XML untuk diurai.

fragType

XmlNodeType

XmlNodeType Fragmen XML. Ini juga menentukan apa yang dapat dimuat string fragmen (lihat tabel di bawah).

context

XmlParserContext

tempat XmlParserContext fragmen XML akan diurai. Ini termasuk NameTable untuk menggunakan, pengodean, cakupan namespace, xml:lang saat ini, dan xml:ruang lingkup.

Pengecualian

XmlException

fragType bukan salah satu jenis node yang tercantum dalam tabel di bawah ini.

Keterangan

Nota

Kelas XmlValidatingReader usang dalam .NET Framework 2.0. Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Konstruktor ini mengurai string yang diberikan sebagai fragmen XML. Jika fragmen XML adalah elemen atau atribut, Anda dapat melewati aturan tingkat akar untuk dokumen XML yang terbentuk dengan baik. Konstruktor ini dapat menangani string yang dikembalikan dari ReadInnerXml.

Tabel berikut ini mencantumkan nilai yang valid untuk fragType dan bagaimana pembaca mengurai masing-masing jenis node yang berbeda.

XmlNodeType	Fragmen Mungkin Berisi
Elemen	Konten elemen yang valid (misalnya, kombinasi elemen, komentar, instruksi pemrosesan, cdata, teks, dan referensi entitas apa pun).
Attribute	Nilai atribut (bagian di dalam tanda kutip).
Dokumen	Konten seluruh dokumen XML; ini memberlakukan aturan tingkat dokumen.

Jika pembaca ini akan memvalidasi dengan menggunakan definisi tipe dokumen (DTD) (yaitu, ValidationType diatur ke ValidationType.DTD atau ValidationType.Auto), XmlParserContext yang ditentukan dalam konstruktor harus menyediakan semua informasi DocumentType yang diperlukan.

Nota

Tidak dimungkinkan untuk memvalidasi fragmen dengan menggunakan DTD. Menurut definisi DTD mengharuskan seluruh dokumen dimuat untuk validasi.

Jika pembaca ini akan memvalidasi dengan menggunakan skema XML-Data Reduced (XDR) atau XML Schema definition language (XSD), gunakan Schemas properti untuk menentukan XmlSchemaCollection yang berisi skema ( XmlParserContext tidak perlu menyediakan informasi DocumentType).

Lihat juga

• XmlReader