ОбъектXmlText

Объект XmlText представляет текстовое содержимое элемента или атрибута.

Узел XmlText представляет последовательность обычного текста в документе XML. Поскольку в элементах и атрибутах XML отображается простой текст, узел XmlText обычноXmlElementсумма узловXmlAttrПоявляются дочерние элементы узла.

Узлы XmlText наследуютсяXmlCharacterDataинтерфейс, черезXmlCharacterDataатрибут данных, унаследованный от интерфейса или отXmlNodeАтрибут nadevalue, унаследованный интерфейсом, может получить доступ к текстовому содержимому узла XmlText.

использовать изXmlCharacterDataУнаследованные методы или метод SplitText(), определенный самим интерфейсом XmlText, могут работать с узлами XmlText. использоватьXmlDocumentcreateTextNode для создания нового узла XmlText.

Узел XmlText не имеет дочерних узлов.

О методах удаления пустых узлов XmlText и объединения соседних узлов XmlText из поддерева документа см.XmlNode.normalizeметод.

отношения наследства

свойства члена

data

Строка, текст, содержащийся в этом узле.

1
String XmlText.data;

length

Целое число, количество символов, содержащихся в этом узле.

1readonly Integer XmlText.length;

nodeType

Целое число, возвращает тип узла.

1readonly Integer XmlText.nodeType;

NodeType разных объектов будет возвращать разные значения:

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_NODE(2)
XmlText: TEXT_NODE(3)
XmlCDATASection: CDATA_SECTION_NODE(4)
XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
XmlComment:COMMENT_NODE(8)
XmlDocument: ДОКУМЕНТ_НОД(9)
XmlDocumentType: DOCUMENT_TYPE_NODE(10)

nodeName

Строка, возвращает имя узла в соответствии с его типом.

1
readonly String XmlText.nodeName;

Имя узла разных объектов будет возвращать разные значения:

XmlElement:имя элемента
XmlAttr: имя атрибута
XmlText: #текст
XmlCDATASection: #cdata-раздел
XmlProcessingInstruction: Возвращает указанную целевую цель
XmlComment: #комментарий
XmlDocument: #документ
XmlDocumentType: имя типа документа

nodeValue

Строка, возвращает имя узла в соответствии с его типом.

1
String XmlText.nodeValue;

Имя узла разных объектов будет возвращать разные значения:

XmlElement: нулевой
XmlAttr: значение атрибута
XmlText: содержимое узла
XmlCDATASection: содержимое узла
XmlProcessingInstruction: Возвращает указанные данные содержимого.
XmlComment: текст аннотации
XmlDocument: нулевой
XmlDocumentType: нулевой

ownerDocument

XmlDocument, возвращает корневой элемент узла (XmlDocumentобъект)

1readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, может вернуть родительский узел узла

1readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, возвращает список дочерних узлов указанного узла

1readonly XmlNodeList XmlText.childNodes;

children

XmlNodeList, возвращает список узлов дочерних элементов указанного узла.

1readonly XmlNodeList XmlText.children;

firstChild

XmlNode, возвращает первый дочерний узел узла

1readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, возвращает последний дочерний узел узла

1readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode, возвращает узел, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, возвращает узел, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlText.nextSibling;

firstElementChild

XmlNode, возвращает первый дочерний элемент узла узла

1readonly XmlNode XmlText.firstElementChild;

lastElementChild

XmlNode, возвращает последний дочерний элемент узла узла

1readonly XmlNode XmlText.lastElementChild;

previousElementSibling

XmlNode, возвращает узел элемента, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlText.previousElementSibling;

nextElementSibling

XmlNode, возвращает узел элемента, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlText.nextElementSibling;

textContent

Строка, запрашивает и устанавливает текст выбранного элемента. При запросе возвращает значения всех текстовых узлов внутри узла элемента; при установке удаляет все дочерние узлы и заменяет их одним текстовым узлом.

1
String XmlText.textContent;

функция-член

splitText

Разделить текстовый узел на два узла в соответствии с указанным смещением.

1XmlText XmlText.splitText(Integer offset);

Параметры звонка:

offset: целое число, указывает, где разбивать текстовые узлы. Начальное значение начинается с 0

Результаты возврата:

XmlText, Текстовый узел, отделенный от текущего узла

Этот метод разделит узел XmlText на два узла по указанному смещению. Исходный узел XmlText будет изменен таким образом, чтобы он содержал текстовое содержимое перед (но не включая) текстовое содержимое в позиции, указанной смещением. Будет создан новый узел XmlText для хранения всех символов от позиции смещения (включая символы в этой позиции) до конца исходного символа. Новый узел XmlText является возвращаемым значением этого метода. Кроме того, если исходный узел XmlText имеет родительский узел, новый узел XmlText будет вставлен в этот родительский узел сразу после исходного узла.

XmlCDATASectionИнтерфейс наследует интерфейс XmlText,XmlCDATASectionУзлы также могут использовать этот метод, но вновь созданные узлыXmlCDATASectionузел вместо узла XmlText.

substringData

Извлечь подстроку из узла

1
2
String XmlText.substringData(Integer offset,
    Integer count);

Параметры звонка:

offset: целое число, позиция первого возвращаемого символа.
count: целое число, количество символов в возвращаемой подстроке.

Результаты возврата:

String, возвращает извлеченную строку

appendData

Добавить строку в узел

1
XmlText.appendData(String arg);

Параметры звонка:

arg: Строка, строка, добавляемая к узлу.

insertData

Вставить строку в узел

1
2XmlText.insertData(Integer offset,
    String arg);

Параметры звонка:

offset: целое число, позиция символа, в которой строка должна быть вставлена в узел.
arg: Строка, строка, которую нужно вставить.

deleteData

Удалить текст из узла

1
2
XmlText.deleteData(Integer offset,
    Integer count);

Параметры звонка:

offset: целое число, позиция первого удаляемого символа.
count: целое число, количество символов для удаления.

replaceData

Заменить символы узла указанной строкой

1
2
3
XmlText.replaceData(Integer offset,
    Integer count,
    String arg);

Параметры звонка:

offset: целое число, позиция символа заменяемого узла.
count: целое число, количество символов для замены.
arg: Строка, строка, которую нужно вставить.

hasChildNodes

Запросить, есть ли дочерние узлы

1
Boolean XmlText.hasChildNodes();

Результаты возврата:

Boolean, возвращает true, если есть дочерние узлы, в противном случае возвращает false

normalize

Объединить соседние текстовые узлы и удалить пустые текстовые узлы.

1XmlText.normalize();

Этот метод пройдет через все узлы-потомки текущего узла и нормализует документ, удалив пустые узлы Text и объединив все соседние узлы Text. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.

cloneNode

Создает точную копию указанного узла

1
XmlNode XmlText.cloneNode(Boolean deep = true);

Параметры звонка:

deep: логическое значение, следует ли выполнять глубокое копирование. Если установлено значение true, клонированный узел клонирует все дочерние узлы исходного узла.

Результаты возврата:

XmlNode, возвращает скопированный узел

Этот метод скопирует и вернет копию узла, на котором он был вызван. Если переданный ему аргумент верен, он также рекурсивно скопирует все узлы-потомки текущего узла. В противном случае он только копирует текущий узел. Возвращенный узел не принадлежит дереву документа, а его свойство родительский узел имеет значение null. При копировании узла Element будут скопированы все его свойства.

lookupPrefix

Возвращает префикс, соответствующий указанному URI пространства имен на текущем узле.

1
String XmlText.lookupPrefix(String namespaceURI);

Параметры звонка:

namespaceURI: строка, указывает соответствующий URI пространства имен.

Результаты возврата:

String, возвращает соответствующий префикс, возвращает ноль, если не совпадает.

lookupNamespaceURI

Возвращает URI пространства имен, соответствующий указанному префиксу на текущем узле.

1
String XmlText.lookupNamespaceURI(String prefix);

Параметры звонка:

prefix: строка, указывает соответствующий префикс.

Результаты возврата:

String, возвращает соответствующий URI пространства имен, возвращает значение null, если не совпадает.

insertBefore

Вставьте новый дочерний узел перед существующим дочерним узлом.

1
2
XmlNode XmlText.insertBefore(XmlNode newChild,
    XmlNode refChild);

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел перед этим узлом

Результаты возврата:

XmlNode, возвращает новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть атрибут OwnerDocument объекта newChild должен совпадать с атрибутом OwnerDocument текущего узла.

insertAfter

Вставьте новый дочерний узел после существующего дочернего узла.

1
2
XmlNode XmlText.insertAfter(XmlNode newChild,
    XmlNode refChild);

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел после этого узла

Результаты возврата:

XmlNode, возвращает новый дочерний узел

appendChild

Добавляет новый дочерний узел в конец списка дочерних узлов узла.

1XmlNode XmlText.appendChild(XmlNode newChild);

Параметры звонка:

newChild:XmlNode, укажите добавленный узел

Результаты возврата:

XmlNode, возвращает этот новый дочерний узел

replaceChild

Заменить дочерний узел другим

1
2
XmlNode XmlText.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Параметры звонка:

newChild:XmlNode, укажите новый узел
oldChild:XmlNode, указывает узел, который будет заменен

Результаты возврата:

XmlNode, Если замена прошла успешно, этот метод может вернуть замененный узел. Если замена не удалась, он возвращает значение null.

removeChild

Удалить узел из списка дочерних узлов

1XmlNode XmlText.removeChild(XmlNode oldChild);

Параметры звонка:

oldChild:XmlNode, указывает узел, который нужно удалить

Результаты возврата:

XmlNode, Если удаление прошло успешно, этот метод может вернуть удаленный узел. В случае неудачи он возвращает значение null.

toString

Возвращает строковое представление объекта. Обычно возвращается «[Native Object]». Объект может быть повторно реализован в соответствии с его собственными характеристиками.

1
String XmlText.toString();

Результаты возврата:

String, возвращает строковое представление объекта

toJSON

Возвращает представление объекта в формате JSON, обычно возвращая коллекцию читаемых свойств, определенных объектом.

1
Value XmlText.toJSON(String key = "");

Параметры звонка:

key: Строка, не используется.

Результаты возврата:

Value, возвращает значение, содержащее сериализуемый JSON

Руководство по разработке

Базовый модуль

встроенные объекты

модуль сообщества

ОбъектXmlText

отношения наследства

свойства члена

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

функция-член

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON