XmlReader.ReadOuterXml Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.dll

Wenn sie in einer abgeleiteten Klasse überschrieben werden, liest sie den Inhalt, einschließlich Markup, der diesen Knoten und alle untergeordneten Elemente darstellt.

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

public virtual string ReadOuterXml();

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

Public Overridable Function ReadOuterXml () As String

Gibt zurück

String

Wenn der Leser auf einem Element oder einem Attributknoten positioniert ist, gibt diese Methode den gesamten XML-Inhalt einschließlich Markup des aktuellen Knotens und aller untergeordneten Elemente zurück. andernfalls wird eine leere Zeichenfolge zurückgegeben.

Ausnahmen

XmlException

Der XML-Code war nicht wohlgeformt, oder beim Analysieren des XML-Codes ist ein Fehler aufgetreten.

InvalidOperationException

Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

Im folgenden Beispiel werden die ReadInnerXml Methoden verglichen 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

Im Beispiel wird die Datei als Eingabe verwendet 2books.xml .

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

Hinweise

Diese Methode ähnelt ReadInnerXml der Ausnahme, dass sie auch die Start- und Endtags zurückgibt.

Diese Methode behandelt Element- und Attributknoten auf folgende Weise:

Knotentyp	Position vor dem Anruf	XML-Fragment	Rückgabewert	Position nach dem Anruf
Element	Auf dem item1 Starttag.	<Element1 Text1<>/Element1><Element2 Text2<>/Element2>	<Element1>Text1</Element1>	Auf dem item2 Starttag.
Attribute	Auf dem attr1 Attributknoten.	<item attr1="val1" attr2="val2">text</item>	attr1="val1"	Verbleibt auf dem attr1 Attributknoten.

Wenn der Leser auf einem Blattknoten positioniert ist, entspricht der Aufruf dem ReadOuterXml Aufrufen Read. Die Methode gibt zurück String.Empty (mit Ausnahme von Attributknoten, in diesem Fall wird das Attributmarkup zurückgegeben).

Diese Methode sucht nach wohlgeformten XML-Daten. Wenn ReadOuterXml von einer Methode XmlValidatingReaderaufgerufen wird, überprüft diese Methode auch den zurückgegebenen Inhalt.

Wie in den XmlNodeReaderKlassen implementiert, XmlTextReader ist XmlValidatingReader die ReadOuterXml Methode namespacefähig. Gibt den folgenden XML-Text <A xmlns:S="urn:1"><S:B>hello</S:B></A>zurück, ReadOuterXml<S:B xmlns:S="urn:1">hello<S:B/>wenn der Leser auf dem S:B Starttag positioniert wurde.

Die asynchrone Version dieser Methode finden Sie unter ReadOuterXmlAsync.