Bagikan melalui

XmlReader.Create Metode

  • Referensi

Definisi

Ruang nama:
System.Xml
Rakitan:
System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.dll
Rakitan:
netstandard.dll

Membuat instans baru XmlReader .

Overload

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 XmlReader baru 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 dan pengaturan teks yang ditentukan.
Create(Stream, XmlReaderSettings)

Membuat instans baru XmlReader dengan aliran 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.

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

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 XmlReader baru. Nilai ini bisa berupa null.

inputContext
XmlParserContext

Informasi konteks yang diperlukan untuk mengurai fragmen XML. Informasi konteks dapat mencakup XmlNameTable penggunaan, pengodean, cakupan namespace, cakupan dan xml:space saat inixml:lang, 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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.

Penting

Anda dapat membatasi sumber daya yang XmlReader dapat diakses dengan mengatur XmlResolver properti ke XmlSecureResolver objek.

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

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 untuk 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 XmlReader baru. Nilai ini bisa berupa null.

inputContext
XmlParserContext

Informasi konteks yang diperlukan untuk mengurai fragmen XML. Informasi konteks dapat mencakup XmlNameTable penggunaan, pengodean, cakupan namespace, cakupan dan xml:space saat inixml:lang, 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 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

Membuat instans XmlReader baru 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 berisikan data XML.

XmlReader Memindai 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 XmlReader baru. Nilai ini bisa berupa null.

inputContext
XmlParserContext

Informasi konteks yang diperlukan untuk mengurai fragmen XML. Informasi konteks dapat mencakup XmlNameTable penggunaan, pengodean, cakupan namespace, cakupan dan xml:space saat inixml:lang, 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 input adalah null.

Keterangan

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

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

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 berisikan 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 XmlReader baru. 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 menyelesaikan 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

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 XmlReader baru.

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.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

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 untuk 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 XmlReader baru. 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 menyelesaikan 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

Membuat instans baru XmlReader dengan menggunakan pembaca dan pengaturan teks 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

Pembaca teks untuk 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 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

Membuat instans baru XmlReader dengan aliran 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 berisikan 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 XmlReader baru. 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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 .

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

Penting

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

-atau-

  • Jangan izinkan XmlReader untuk membuka sumber daya eksternal apa pun dengan mengatur properti ke nullXmlResolver .

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

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 Bursa Windows atau Pustaka Kelas Portabel, 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 teruskan 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.

Penting

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 .

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

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

Pembaca teks untuk 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.

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

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 teruskan 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.

Penting

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 .

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

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 berisikan data XML.

XmlReader Memindai 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).

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 berbunyi 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

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 teruskan 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.

Penting

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 .

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

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

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 XmlReader baru. 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 Bursa Windows atau Pustaka Kelas Portabel, 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 XmlUrlResolver tanpa kredensial digunakan untuk mengakses sumber daya eksternal apa pun seperti definisi jenis dokumen (DTD), entitas, skema, dan sebagainya.

Penting

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.

Penting

Anda dapat membatasi sumber daya yang XmlReader dapat diakses dengan mengatur XmlResolver properti ke XmlSecureResolver objek.

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

Berlaku untuk