Чтение содержимого
Обновлен: November 2007
Класс XmlReader содержит элементы, которые используются для считывания содержимого.
.gif "Примечание") Примечание. |
|---|
Элементы, описанные в этом разделе, возвращают содержимое в виде строковых значений. Сведения о считывании типизированного содержимого см. в разделе Чтение типизированных данных. |
Свойство Value
С помощью свойства Value можно получить текстовое содержимое текущего узла. Возвращаемое значение зависит от типа текущего узла. В следующей таблице описано содержимое, возвращаемое для каждого из возможных типов узла.
Тип узла |
Значение |
|---|---|
Attribute |
Значение атрибута. |
CDATA |
Содержимое раздела CDATA. |
Comment |
Содержимое комментария. |
DocumentType |
Внутреннее подмножество. |
ProcessingInstruction |
Все содержимое, за исключением цели. |
SignificantWhitespace |
Пробелы между разметкой в модели смешанного содержимого. |
Text |
Содержимое текстового узла. |
Whitespace |
Пробелы между разметкой. |
XmlDeclaration |
Содержимое декларации. |
Все остальные типы узлов |
Пустая строка. |
Метод ReadString
Метод ReadString возвращает содержимое элемента или текстового узла в виде строки.
Если объект XmlReader расположен в элементе, метод ReadString объединяет весь текст, значащие и прочие пробелы, а также узлы раздела CDATA и возвращает объединенные данные в качестве содержимого элемента. Модуль чтения останавливается, если обнаруживает элемент разметки. Это может случиться в модели смешанного содержимого или во время считывания закрывающего тега элемента.
Если объект XmlReader расположен в текстовом узле, метод ReadString выполняет такое же объединение текста, пробелов и узлов раздела CDATA. Модуль останавливается на первом узле, который имеет тип, отличный от упомянутых ранее. Если модуль чтения расположен в текстовом узле атрибута, метод ReadString работает так же, как в случае, когда модуль чтения располагается в открывающем теге элемента, и возвращает все объединенные текстовые узлы элемента.
| Примечание. |
|---|
Метод ReadString останавливается на обработке инструкций и комментариев, но не пропускает их. |
Метод ReadInnerXml
Метод ReadInnerXml возвращает все содержимое текущего узла, включая разметку. Текущий узел (открывающий тег) и соответствующий ему конечный узел (закрывающий тег) не возвращаются. Например, если выбрана XML-строка <node>this<child id="123"/></node>, метод ReadInnerXml вернет this<child id="123"/>.
В следующей таблице описано, как обрабатываются узлы элементов и атрибутов.
Тип узла |
Исходное расположение |
XML-фрагмент |
Возвращаемое значение |
Заключительное положение |
|---|---|---|---|---|
Element |
В начальном теге item1. |
<item1>text1</item1><item2>text2</item2> |
text1 |
В начальном теге item2. |
Атрибут |
В узле атрибута attr1. |
<item attr1="val1" attr2="val2">text</item> |
val1 |
Остается в узле атрибута attr1. |
Если модуль чтения располагается в конечном узле, вызов метода ReadInnerXml будет равносилен вызову метода Read.
Метод ReadOuterXml
Метод ReadOuterXml возвращает все XML-содержимое (включая разметку) текущего узла и всех его дочерних узлов. Метод работает аналогично методу ReadInnerXml, но также возвращает открывающий и закрывающий теги.
Согласно значениям в таблице выше, если модуль чтения расположен в открывающем теге item1, метод ReadOuterXml возвращает <item1>text1</item1>. Если модуль чтения расположен в узле атрибута attr1, метод ReadOuterXml возвращает attr1="val1".