ОбъектXmlКомментарий

Объекты XmlComment представляют содержимое узлов комментариев в документе.

Узел XmlComment представляет комментарий в XML-документе. ИспользованXmlCharacterDataАтрибут данных, унаследованный интерфейсом или с помощьюXmlNodeАтрибут nodeValue, унаследованный интерфейсом, может получить доступ к содержимому аннотации. (т. е. текст между ). ИспользованXmlCharacterDataС содержимым аннотации могут работать различные методы, унаследованные от интерфейса.

использоватьXmlDocument.createComment(), чтобы создать объект аннотации.

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

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

data

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

1
String XmlComment.data;

length

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

1readonly Integer XmlComment.length;

nodeType

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

1readonly Integer XmlComment.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 XmlComment.nodeName;

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

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

nodeValue

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

1
String XmlComment.nodeValue;

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

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

ownerDocument

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

1readonly XmlDocument XmlComment.ownerDocument;

parentNode

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

1readonly XmlNode XmlComment.parentNode;

childNodes

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

1readonly XmlNodeList XmlComment.childNodes;

children

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

1readonly XmlNodeList XmlComment.children;

firstChild

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

1readonly XmlNode XmlComment.firstChild;

lastChild

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

1readonly XmlNode XmlComment.lastChild;

previousSibling

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

1readonly XmlNode XmlComment.previousSibling;

nextSibling

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

1readonly XmlNode XmlComment.nextSibling;

firstElementChild

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

1readonly XmlNode XmlComment.firstElementChild;

lastElementChild

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

1readonly XmlNode XmlComment.lastElementChild;

previousElementSibling

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

1readonly XmlNode XmlComment.previousElementSibling;

nextElementSibling

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

1readonly XmlNode XmlComment.nextElementSibling;

textContent

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

1
String XmlComment.textContent;

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

substringData

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

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

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

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

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

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

appendData

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

1
XmlComment.appendData(String arg);

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

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

insertData

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

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

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

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

deleteData

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

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

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

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

replaceData

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

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

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

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

hasChildNodes

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

1
Boolean XmlComment.hasChildNodes();

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

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

normalize

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

1XmlComment.normalize();

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

cloneNode

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

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

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

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

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

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

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

lookupPrefix

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

1
String XmlComment.lookupPrefix(String namespaceURI);

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

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

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

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

lookupNamespaceURI

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

1
String XmlComment.lookupNamespaceURI(String prefix);

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

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

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

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

insertBefore

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

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

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

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

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

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

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

insertAfter

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

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

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

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

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

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

appendChild

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

1XmlNode XmlComment.appendChild(XmlNode newChild);

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

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

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

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

replaceChild

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

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

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

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

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

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

removeChild

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

1XmlNode XmlComment.removeChild(XmlNode oldChild);

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

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

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

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

toString

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

1
String XmlComment.toString();

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

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

toJSON

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

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

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

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

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

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

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

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

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

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

ОбъектXmlКомментарий

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

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

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

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

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON