XmlReader.ReadInnerXml Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Při přepsání v odvozené třídě přečte veškerý obsah, včetně revizí, jako řetězec.

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

Návraty

String

Veškerý obsah XML, včetně značek, v aktuálním uzlu. Pokud aktuální uzel nemá žádné podřízené položky, vrátí se prázdný řetězec.

Pokud aktuální uzel není prvek ani atribut, vrátí se prázdný řetězec.

Výjimky

XmlException

Xml nebyl správně vytvořen nebo došlo k chybě při analýze XML.

InvalidOperationException

XmlReader Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Příklady

Následující příklad porovnává metody ReadInnerXml a ReadOuterXml metody.

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

Příklad používá 2books.xml soubor jako vstup.

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

Poznámky

Tato metoda vrátí veškerý obsah aktuálního uzlu včetně revize. Aktuální uzel (počáteční značka) a odpovídající koncový uzel (koncová značka) se nevrátí. Pokud jste například měli následující:

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

ReadInnerXml Vrátí this <child id="123"/>

Tato metoda zpracovává uzly elementů a atributů následujícím způsobem:

Typ uzlu	Pozice před voláním	Fragment XML	Vrácená hodnota	Pozice po volání
Element	item1 Na počáteční značce.	<item1>text1text2</item1><item2></item2>	text1	item2 Na počáteční značce.
Attribute	Na uzlu atributu attr1 .	<item attr1="val1" attr2="val2">text</item>	val1	Zůstane na uzlu atributu attr1 .

Pokud je čtečka umístěna na listovém uzlu, volání ReadInnerXml je ekvivalentní volání Read. Metoda vrátí String.Empty (s výjimkou uzlů atributů, v takovém případě se vrátí hodnota atributu).

Tato metoda kontroluje správně formátovaný XML. Pokud ReadInnerXml se volá z objektu XmlValidatingReader, tato metoda také ověří vrácený obsah.

Jak je implementováno XmlNodeReaderv a XmlValidatingReader XmlTextReader třídy ReadOuterXml metody je znám obor názvů.

Asynchronní verze této metody naleznete v tématu ReadInnerXmlAsync.