XmlReader.Create Metode

Definisi

Ruang nama:: System.Xml

Rakitan:: netstandard.dll, System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Rakitan:: System.Xml.dll, System.Xml.ReaderWriter.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat instans XmlReader baru.

Overload

Nama	Deskripsi
Create(String, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader dengan menggunakan URI, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(Stream, XmlReaderSettings, XmlParserContext)	Membuat instans baru XmlReader menggunakan streaming, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.
Create(Stream, XmlReaderSettings, String)	Membuat instans baru XmlReader menggunakan aliran, URI dasar, dan pengaturan yang ditentukan.
Create(XmlReader, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan pembaca dan pengaturan XML yang ditentukan.
Create(TextReader, XmlReaderSettings, String)	Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan URI dasar yang ditentukan.
Create(TextReader, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan pembaca teks dan pengaturan yang ditentukan.
Create(Stream, XmlReaderSettings)	Membuat instans baru XmlReader dengan streaming dan pengaturan yang ditentukan.
Create(String)	Membuat instans baru XmlReader dengan URI tertentu.
Create(TextReader)	Membuat instans baru XmlReader dengan menggunakan pembaca teks yang ditentukan.
Create(Stream)	Membuat instans baru XmlReader menggunakan aliran yang ditentukan dengan pengaturan default.
Create(String, XmlReaderSettings)	Membuat instans baru XmlReader dengan menggunakan URI dan pengaturan yang ditentukan.

Contoh

Contoh ini membuat pembaca XML yang menghapus spasi putih yang tidak signifikan, menghapus komentar, dan melakukan pemeriksaan kesesuaian tingkat fragmen.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

Contoh berikut menggunakan XmlUrlResolver dengan kredensial default untuk mengakses file.

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;

' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);

' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

Kode berikut membungkus instans pembaca dalam pembaca lain.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

Contoh ini menautkan pembaca untuk menambahkan validasi skema DTD dan XML.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation

Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Keterangan

Sebagian besar overload Create mencakup parameter settings yang menerima objek XmlReaderSettings. Anda dapat menggunakan objek ini untuk:

Tentukan fitur mana yang ingin Didukung pada XmlReader objek.
Gunakan objek XmlReaderSettings kembali untuk membuat beberapa pembaca. Anda dapat menggunakan pengaturan yang sama untuk membuat beberapa pembaca dengan fungsionalitas yang sama. Atau, Anda dapat mengubah pengaturan pada XmlReaderSettings instans dan membuat pembaca baru dengan serangkaian fitur yang berbeda.
Tambahkan fitur ke pembaca XML yang sudah ada. Metode Create ini dapat menerima objek lain XmlReader . Objek dasar XmlReader dapat menjadi pembaca yang didefinisikan pengguna, objek XmlTextReader, atau instans lain XmlReader yang ingin Anda tambahkan fitur tambahan.
Manfaatkan fitur sepenuhnya seperti pemeriksaan kesamaan yang lebih baik dan kepatuhan terhadap rekomendasi XML 1.0 (edisi keempat) yang hanya tersedia pada XmlReader objek yang dibuat oleh metode statis Create .

Note

Meskipun .NET menyertakan implementasi konkret kelas XmlReader , seperti XmlTextReader, , XmlNodeReaderdan XmlValidatingReader kelas, kami sarankan Anda membuat XmlReader instans dengan menggunakan Create metode .

Pengaturan bawaan

Jika Anda menggunakan Create overload yang tidak menerima objek XmlReaderSettings, pengaturan default pembaca berikut ini akan digunakan.

Setting	Default
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Objek kosong XmlSchemaSet
ValidationFlags	ProcessIdentityConstraints Diaktifkan
ValidationType	None
XmlResolver	`null`

Pengaturan untuk skenario umum

Berikut adalah properti yang XmlReaderSettings harus Anda tetapkan untuk beberapa skenario pembaca XML umum.

Persyaratan	Menetapkan
Data harus berupa dokumen XML yang terbentuk dengan baik.	ConformanceLevel ke Document.
Data harus merupakan entitas yang diurai XML yang terbentuk dengan baik.	ConformanceLevel ke Fragment.
Data harus divalidasi terhadap DTD.	DtdProcessing ke Parse ValidationType ke DTD.
Data harus divalidasi terhadap skema XML.	ValidationType ke Schema Schemas ke XmlSchemaSet yang digunakan untuk validasi. Perhatikan bahwa XmlReader tidak mendukung validasi skema XML-Data Reduced (XDR).
Data harus divalidasi terhadap skema XML sebaris.	ValidationType ke Schema ValidationFlags ke ProcessInlineSchema.
Ketik dukungan.	ValidationType ke Schema Schemas untuk XmlSchemaSet digunakan.

XmlReader tidak mendukung validasi skema XML-Data Reduced (XDR).

Pemrograman asinkron

Dalam mode sinkron, metode Create membaca bagian data pertama dari buffer file, aliran, atau pembaca teks. Ini dapat menghasilkan pengecualian jika operasi I/O gagal. Dalam mode asinkron, operasi I/O pertama terjadi dengan operasi baca, sehingga pengecualian yang muncul akan dilemparkan ketika operasi baca terjadi.

Pertimbangan keamanan

Secara default, XmlReader menggunakan XmlUrlResolver objek tanpa kredensial pengguna untuk membuka sumber daya. Ini berarti bahwa, secara default, pembaca XML dapat mengakses lokasi apa pun yang tidak memerlukan kredensial. XmlResolver Gunakan properti untuk mengontrol akses ke sumber daya:

Gunakan ThrowingResolver untuk membatasi sumber daya yang dapat diakses pembaca XML, atau...
Atur XmlResolver ke null untuk mencegah pembaca XML membuka sumber daya eksternal apa pun.

Create(String, XmlReaderSettings, XmlParserContext)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan URI, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameter

inputUri: String

URI untuk file yang berisi data XML. Objek XmlResolver pada XmlReaderSettings objek digunakan untuk mengonversi jalur ke representasi data kanonis. Jika XmlResolver adalah null, objek baru XmlUrlResolver digunakan.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

inputContext: XmlParserContext

Informasi konteks yang diperlukan untuk mengurai fragmen XML. Informasi konteks dapat mencakup XmlNameTable untuk menggunakan, pengodean, cakupan namespace, cakupan dan xml:lang saat inixml:space, URI dasar, dan definisi jenis dokumen.

Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai inputUri adalah null.

SecurityException

XmlReader tidak memiliki izin yang memadai untuk mengakses lokasi data XML.

ArgumentException

Properti NameTable dan NameTable keduanya berisi nilai. (Hanya salah satu properti ini NameTable yang dapat diatur dan digunakan).

FileNotFoundException

File yang ditentukan oleh URI tidak dapat ditemukan.

UriFormatException

Format URI tidak benar.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Dimulai dengan .NET Framework 4.5.2, tidak ada default XmlUrlResolver yang disediakan. Jika solusi Anda menargetkan .NET Framework 4.5.2 atau versi yang XmlResolver lebih baru, tentukan menggunakan XmlReaderSettings.XmlResolver properti .

Ini berarti bahwa XmlReader dapat mengakses lokasi apa pun yang tidak memerlukan autentikasi. Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat membatasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(TextReader, XmlReaderSettings, XmlParserContext)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameter

input: TextReader

Pembaca teks tempat membaca data XML. Pembaca teks mengembalikan aliran karakter Unicode, sehingga pengodean yang ditentukan dalam deklarasi XML tidak digunakan oleh pembaca XML untuk mendekode aliran data.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

inputContext: XmlParserContext

Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

ArgumentException

Properti NameTable dan NameTable keduanya berisi nilai. (Hanya salah satu properti ini NameTable yang dapat diatur dan digunakan.)

Contoh

Contoh berikut membuat XmlReader objek yang membaca fragmen XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(Stream, XmlReaderSettings, XmlParserContext)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader menggunakan streaming, pengaturan, dan informasi konteks yang ditentukan untuk penguraian.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameter

input: Stream

Aliran yang berisi data XML.

Memindai XmlReader byte pertama aliran yang mencari tanda urutan byte atau tanda pengodean lainnya. Saat pengodean ditentukan, pengodean digunakan untuk terus membaca aliran, dan pemrosesan terus mengurai input sebagai aliran karakter (Unicode).

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

inputContext: XmlParserContext

Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(Stream, XmlReaderSettings, String)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader menggunakan aliran, URI dasar, dan pengaturan yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameter

input: Stream

Aliran yang berisi data XML.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

baseUri: String

URI dasar untuk entitas atau dokumen yang sedang dibaca. Nilai ini bisa berupa null.

Catatan Keamanan URI dasar digunakan untuk mengatasi URI relatif dokumen XML. Jangan gunakan URI dasar dari sumber yang tidak tepercaya.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(XmlReader, XmlReaderSettings)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan pembaca dan pengaturan XML yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parameter

reader: XmlReader

Objek yang ingin Anda gunakan sebagai pembaca XML yang mendasar.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader .

Tingkat kesuaian XmlReaderSettings objek harus cocok dengan tingkat kesuaian pembaca yang mendasar, atau harus diatur ke Auto.

Mengembalikan

XmlReader

Objek yang dibungkus di sekitar objek yang ditentukan XmlReader .

Pengecualian

ArgumentNullException

Nilai reader adalah null.

InvalidOperationException

XmlReaderSettings Jika objek menentukan tingkat kesuaian yang tidak konsisten dengan tingkat kesuaian pembaca yang mendasar.

-atau-

Yang mendasar XmlReader berada dalam status Error atau Closed .

Contoh

Contoh berikut membuat objek validasi XmlReader yang dibungkus di sekitar XmlNodeReader objek.

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

Keterangan

Metode ini memungkinkan Anda menambahkan fitur tambahan ke objek yang mendasar XmlReader . Objek yang mendasar XmlReader dapat menjadi objek lain XmlReader yang dibuat oleh Create metode , atau objek yang XmlReader dibuat menggunakan salah satu implementasi konkret XmlReader .

Default XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti skema.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, tentukan dengan kredensial yang XmlResolver diperlukan menggunakan XmlReaderSettings.XmlResolver properti .

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(TextReader, XmlReaderSettings, String)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan pembaca teks, pengaturan, dan URI dasar yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameter

input: TextReader

Pembaca teks tempat membaca data XML. Pembaca teks mengembalikan aliran karakter Unicode, sehingga pengodean yang ditentukan dalam deklarasi XML tidak digunakan oleh XmlReader untuk mendekode aliran data.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

baseUri: String

URI dasar untuk entitas atau dokumen yang sedang dibaca. Nilai ini bisa berupa null.

Catatan Keamanan URI dasar digunakan untuk mengatasi URI relatif dokumen XML. Jangan gunakan URI dasar dari sumber yang tidak tepercaya.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(TextReader, XmlReaderSettings)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan pembaca teks dan pengaturan yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parameter

input: TextReader

settings: XmlReaderSettings

Pengaturan untuk yang baru XmlReader. Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(Stream, XmlReaderSettings)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan streaming dan pengaturan yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parameter

input: Stream

Aliran yang berisi data XML.

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan XmlReaderSettings.XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Important

Anda dapat menggunakan salah satu metode berikut untuk mengontrol sumber daya mana yang XmlReader dapat diakses:

Batasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.
Jangan izinkan XmlReader membuka sumber daya eksternal apa pun dengan mengatur properti XmlResolver ke null.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(String)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan URI tertentu.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);

public static System.Xml.XmlReader Create(string inputUri);

static member Create : string -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String) As XmlReader

Parameter

inputUri: String

URI untuk file yang berisi data XML. Kelas XmlUrlResolver digunakan untuk mengonversi jalur ke representasi data kanonis.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai inputUri adalah null.

SecurityException

XmlReader tidak memiliki izin yang memadai untuk mengakses lokasi data XML.

FileNotFoundException

File yang diidentifikasi oleh URI tidak ada.

UriFormatException

Format URI tidak benar.

Catatan: Di .NET untuk aplikasi Windows Store atau Pustaka Kelas Portable, tangkap pengecualian kelas dasar, FormatException, sebagai gantinya.

Contoh

Contoh berikut membuat XmlReader objek yang membaca file data XML yang ditentukan oleh URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("books.xml")

Keterangan

Objek XmlReaderSettings dengan pengaturan default digunakan untuk membuat pembaca. Jika Anda ingin menentukan fitur yang akan didukung pada pembaca yang dibuat, gunakan kelebihan beban yang mengambil XmlReaderSettings objek sebagai salah satu argumennya, dan meneruskan objek dengan pengaturan yang XmlReaderSettings benar.

Default XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, tentukan dengan kredensial yang XmlResolver diperlukan menggunakan XmlReaderSettings.XmlResolver properti .

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(TextReader)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan pembaca teks yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);

public static System.Xml.XmlReader Create(System.IO.TextReader input);

static member Create : System.IO.TextReader -> System.Xml.XmlReader

Public Shared Function Create (input As TextReader) As XmlReader

Parameter

input: TextReader

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

Contoh

Contoh berikut menggunakan StringReader kelas untuk membaca string XML.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Keterangan

Default XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, tentukan dengan kredensial yang XmlResolver diperlukan menggunakan XmlReaderSettings.XmlResolver properti .

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(Stream)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader menggunakan aliran yang ditentukan dengan pengaturan default.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);

public static System.Xml.XmlReader Create(System.IO.Stream input);

static member Create : System.IO.Stream -> System.Xml.XmlReader

Public Shared Function Create (input As Stream) As XmlReader

Parameter

input: Stream

Aliran yang berisi data XML.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai input adalah null.

SecurityException

XmlReader tidak memiliki izin yang memadai untuk mengakses lokasi data XML.

Contoh

Contoh berikut membuat XmlReader objek yang dibaca dari FileStream.


FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

Keterangan

Default XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, tentukan dengan kredensial yang XmlResolver diperlukan menggunakan XmlReaderSettings.XmlResolver properti .

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Create(String, XmlReaderSettings)

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Sumber:: XmlReader.cs

Membuat instans baru XmlReader dengan menggunakan URI dan pengaturan yang ditentukan.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings settings);

public static System.Xml.XmlReader Create(string inputUri, System.Xml.XmlReaderSettings? settings);

static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parameter

inputUri: String

settings: XmlReaderSettings

Pengaturan untuk instans baru XmlReader . Nilai ini bisa berupa null.

Mengembalikan

XmlReader

Objek yang digunakan untuk membaca data XML di aliran.

Pengecualian

ArgumentNullException

Nilai inputUri adalah null.

FileNotFoundException

File yang ditentukan oleh URI tidak dapat ditemukan.

UriFormatException

Format URI tidak benar.

Catatan: Di .NET untuk aplikasi Windows Store atau Pustaka Kelas Portable, tangkap pengecualian kelas dasar, FormatException, sebagai gantinya.

Contoh

Contoh berikut membuat XmlReader objek yang mendukung validasi definisi jenis dokumen (DTD).

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

Keterangan

Secara default tanpa XmlUrlResolver kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Important

Anda dapat membatasi sumber daya yang XmlReader dapat diakses dengan menggunakan ThrowingResolver.

Objek yang dibuat XmlReader memperluas referensi entitas dan melakukan normalisasi XML karakter baris baru.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?