XmlReader.ReadOuterXml Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Когда переопределено в производном классе, считывает содержимое, включая разметку, представляющую этот узел и все его дочерние узлы.

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

Возвращаемое значение

String

Если средство чтения позиционировано на узел элемента или атрибута, данный метод возвращает все содержимое XML текущего узла и всех его дочерних узлов, включая разметку; в противном случае возвращается пустая строка.

Исключения

XmlException

Неправильный формат XML, или при синтаксическом анализе XML произошла ошибка.

InvalidOperationException

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Примеры

В следующем примере сравниваются ReadInnerXml методы и 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

В этом примере в качестве входных данных используется 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>

Комментарии

Этот метод аналогичен тому, что ReadInnerXml он также возвращает начальные и конечные теги.

Этот метод обрабатывает узлы элементов и атрибутов следующим образом:

Тип узла	Позиция перед вызовом	XML-фрагмент	Возвращаемое значение	Положение после вызова
Element	В открывающем теге item1.	<item1>text1text2</item1><item2></item2>	<item1>text1</item1>	В открывающем теге item2.
Attribute	В узле атрибута attr1.	<item attr1="val1" attr2="val2">text</item>	attr1="val1"	Остается в узле атрибута attr1.

Если модуль чтения располагается в конечном узле, вызов метода ReadOuterXml будет равносилен вызову метода Read. Метод возвращает ( String.Empty за исключением узлов атрибутов, в этом случае возвращается разметка атрибута).

Этот метод проверяет наличие xml-кода правильного формата. При ReadOuterXml вызове из метода XmlValidatingReaderэтот метод также проверяет возвращенное содержимое.

Как реализовано в , XmlNodeReaderXmlTextReader и XmlValidatingReader классыReadOuterXml, которые метод учитывает пространство имен. Если модуль чтения размещен в начальном теге, возвращается <S:B xmlns:S="urn:1">hello<S:B/>следующий XML-текст<A xmlns:S="urn:1"><S:B>hello</S:B></A>. ReadOuterXml S:B

Асинхронная версия этого метода см. в разделе ReadOuterXmlAsync.