XmlReader.ReadInnerXml Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Saat ditimpa di kelas turunan, membaca semua konten, termasuk markup, sebagai string.

public:
 virtual System::String ^ ReadInnerXml();

public virtual string ReadInnerXml();

abstract member ReadInnerXml : unit -> string
override this.ReadInnerXml : unit -> string

Public Overridable Function ReadInnerXml () As String

Mengembalikan

String

Semua konten XML, termasuk markup, di simpul saat ini. Jika simpul saat ini tidak memiliki turunan, string kosong dikembalikan.

Jika simpul saat ini bukan elemen atau atribut, string kosong dikembalikan.

Pengecualian

XmlException

XML tidak terbentuk dengan baik, atau terjadi kesalahan saat mengurai XML.

InvalidOperationException

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

Contoh berikut membandingkan ReadInnerXml metode dan ReadOuterXml .

// Load the file and ignore all white space.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreWhitespace = true;
using (XmlReader reader = XmlReader.Create("2books.xml")) {

  // Moves the reader to the root element.
  reader.MoveToContent();

  // Moves to book node.
  reader.Read();

  // Note that ReadInnerXml only returns the markup of the node's children
  // so the book's attributes are not returned.
  Console.WriteLine("Read the first book using ReadInnerXml...");
  Console.WriteLine(reader.ReadInnerXml());

  // ReadOuterXml returns the markup for the current node and its children
  // so the book's attributes are also returned.
  Console.WriteLine("Read the second book using ReadOuterXml...");
  Console.WriteLine(reader.ReadOuterXml());
}

' Load the file and ignore all white space.
Dim settings As New XmlReaderSettings()
settings.IgnoreWhitespace = True
Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Moves the reader to the root element.
  reader.MoveToContent()

  ' Moves to book node.
  reader.Read()

  ' Note that ReadInnerXml only returns the markup of the node's children
  ' so the book's attributes are not returned.
  Console.WriteLine("Read the first book using ReadInnerXml...")
  Console.WriteLine(reader.ReadInnerXml())

  ' ReadOuterXml returns the markup for the current node and its children
  ' so the book's attributes are also returned.
  Console.WriteLine("Read the second book using ReadOuterXml...")
  Console.WriteLine(reader.ReadOuterXml())

End Using

Contohnya menggunakan 2books.xml file sebagai input.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Keterangan

Metode ini mengembalikan semua konten simpul saat ini termasuk markup. Simpul saat ini (tag mulai) dan simpul akhir yang sesuai (tag akhir) tidak dikembalikan. Misalnya, jika Anda memiliki hal berikut:

<node>
 this <child id="123"/>
</node>

ReadInnerXml menghasilkan this <child id="123"/>

Metode ini menangani elemen dan node atribut dengan cara berikut:

Jenis node	Posisi sebelum panggilan	Fragmen XML	Mengembalikan nilai	Posisi setelah panggilan
Element	item1 Pada tag mulai.	<item1>text1</item1><item2 text2></item2>	text1	item2 Pada tag mulai.
Attribute	Pada node attr1 atribut.	<item attr1="val1" attr2="val2">text</item>	val1	Tetap pada node attr1 atribut.

Jika pembaca diposisikan pada simpul daun, panggilan ReadInnerXml setara dengan panggilan Read. Metode mengembalikan String.Empty (kecuali untuk node atribut, dalam hal ini nilai atribut dikembalikan).

Metode ini memeriksa XML yang terbentuk dengan baik. Jika ReadInnerXml dipanggil dari XmlValidatingReader, metode ini juga memvalidasi konten yang dikembalikan.

Seperti yang XmlNodeReaderdiimplementasikan dalam kelas XmlTextReader , XmlValidatingReader dan ReadOuterXml metode sadar namespace.

Untuk versi asinkron dari metode ini, lihat ReadInnerXmlAsync.