Объект XmlCDATASection

Объект XmlCDATASection представляет раздел CDATA в документе

Интерфейс XmlCDATASection является подчиненным интерфейсом интерфейса XmlText и не определяет какие-либо из его собственных свойств и методов. Вы можете получить доступ к текстовому содержимому раздела CDATA, унаследовав свойство nodeValue из интерфейса XmlNode или унаследовав свойство data из интерфейса XmlCharacterData .

Хотя узел XmlCDATASection обычно можно рассматривать как узел XmlText , следует отметить, что метод нормализации XmlNode не включен в соседний раздел CDATA.

Используйте метод XmlDocument createXmlCDATASection для создания XmlCDATASection.

Раздел CDATA содержит текст, который не будет анализироваться парсером. Теги в разделе CDATA не будут считаться тегами, а объекты не будут расширяться. Основная цель состоит в том, чтобы включать такие материалы, как фрагменты XML, без необходимости использовать все разделители.

Единственный распознаваемый разделитель в CDATA - это «]]>», который может обозначать конец раздела CDATA. Разделы CDATA не могут быть вложенными.

наследование

Атрибут члена

data

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

1
String XmlCDATASection.data;

length

Целое число, количество символов в этом узле

1readonly Integer XmlCDATASection.length;

nodeType

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

1readonly Integer XmlCDATASection.nodeType;

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

XmlElement : ELEMENT_NODE (1)
XmlAttr : XmlAttr (2)
XmlText : TEXT_NODE (3)
XmlCDATASection : CDATA_SECTION_NODE (4)
XmlProcessingInstruction : PROCESSING_INSTRUCTION_NODE (7)
XmlComment : COMMENT_NODE (8)
XmlDocument : DOCUMENT_NODE (9)
XmlDocumentType : DOCUMENT_TYPE_NODE (10)

nodeName

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

1
readonly String XmlCDATASection.nodeName;

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

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

nodeValue

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

1
String XmlCDATASection.nodeValue;

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

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

ownerDocument

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

1readonly XmlDocument XmlCDATASection.ownerDocument;

parentNode

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

1readonly XmlNode XmlCDATASection.parentNode;

childNodes

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

1readonly XmlNodeList XmlCDATASection.childNodes;

firstChild

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

1readonly XmlNode XmlCDATASection.firstChild;

lastChild

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

1readonly XmlNode XmlCDATASection.lastChild;

previousSibling

XmlNode , возвращает узел непосредственно перед узлом (на том же уровне дерева), если такого узла нет, тогда это свойство возвращает нуль

1readonly XmlNode XmlCDATASection.previousSibling;

nextSibling

XmlNode , возвращает узел сразу после элемента (на том же уровне дерева), если такого узла нет, атрибут возвращает ноль

1readonly XmlNode XmlCDATASection.nextSibling;

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

splitText

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

1XmlText XmlCDATASection.splitText(Integer offset);

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

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

Вернуть результат:

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

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

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

substringData

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

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

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

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

Вернуть результат:

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

appendData

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

1
XmlCDATASection.appendData(String arg);

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

arg : String, строка для добавления к узлу

insertData

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

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

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

offset : Integer, позиция символа узла, который будет вставлен в строку
arg : String, строка для вставки

deleteData

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

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

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

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

replaceData

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

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

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

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

hasChildNodes

Проверьте, есть ли дочерний узел

1
Boolean XmlCDATASection.hasChildNodes();

Вернуть результат:

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

normalize

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

1XmlCDATASection.normalize();

Этот метод будет перебирать всех потомков текущего узла, удаляя пустой текстовый узел, объединив все смежные текстовые узлы для нормализации документа. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.

cloneNode

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

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

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

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

Вернуть результат:

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

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

lookupPrefix

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

1
String XmlCDATASection.lookupPrefix(String namespaceURI);

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

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

Вернуть результат:

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

lookupNamespaceURI

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

1
String XmlCDATASection.lookupNamespaceURI(String prefix);

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

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

Вернуть результат:

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

insertBefore

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

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

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

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

Вернуть результат:

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

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

insertAfter

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

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

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

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

Вернуть результат:

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

appendChild

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

1XmlNode XmlCDATASection.appendChild(XmlNode newChild);

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

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

Вернуть результат:

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

replaceChild

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

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

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

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

Вернуть результат:

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

removeChild

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

1XmlNode XmlCDATASection.removeChild(XmlNode oldChild);

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

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

Вернуть результат:

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

toString

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

1
String XmlCDATASection.toString();

Вернуть результат:

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

toJSON

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

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

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

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

Вернуть результат:

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

Руководство по развитию

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

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

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

Объект XmlCDATASection

наследование

Атрибут члена

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

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

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON