Объект XmlComment
Объект XmlComment представляет содержимое узла комментария в документе.
Узел XmlComment представляет комментарий в XML-документе. ИспользованXmlCharacterData Атрибут данных, унаследованный интерфейсом, или используйте XmlNodeСвойство nodeValue, унаследованное интерфейсом, может получить доступ к содержимому аннотации. (То есть текст между ними). ИспользованXmlCharacterData Различные методы, унаследованные интерфейсом, могут управлять содержимым комментария.
использовать XmlDocument.createComment() для создания объекта комментария.
Наследование
Атрибуты члена
data
Строка, текст, содержащийся в узле
1String XmlComment.data;
length
Целое число, количество символов, содержащихся в узле.
1readonly Integer XmlComment.length;
nodeType
Целое число, возвращает тип узла узла
1readonly Integer XmlComment.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: DOCUMENT_NODE (9)
- XmlDocumentType: DOCUMENT_TYPE_NODE (10)
nodeName
String, возвращает имя узла в соответствии с его типом
1readonly String XmlComment.nodeName;
NodeName разных объектов будет возвращать разные значения:
- XmlElement: имя элемента
- XmlAttr: Имя свойства
- XmlText: #text
- XmlCDATASection: # cdata-section
- XmlProcessingInstruction: Вернуться к указанной цели
- XmlComment: #comment
- XmlDocument: # документ
- XmlDocumentType: имя типа документа
nodeValue
String, возвращает имя узла в соответствии с его типом
1String XmlComment.nodeValue;
NodeName разных объектов будет возвращать разные значения:
- 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;
firstChild
XmlNode, Верните первый дочерний узел узла
1readonly XmlNode XmlComment.firstChild;
lastChild
XmlNode, Вернуть последний дочерний узел узла
1readonly XmlNode XmlComment.lastChild;
previousSibling
XmlNode, Возвращает узел непосредственно перед определенным узлом (на том же уровне дерева), если такого узла нет, то атрибут возвращает ноль
1readonly XmlNode XmlComment.previousSibling;
nextSibling
XmlNode, Возвращает узел, следующий сразу за элементом (на том же уровне дерева), если такого узла нет, свойство возвращает null
1readonly XmlNode XmlComment.nextSibling;
Функция члена
substringData
Извлечь подстроку из узла
1
2String XmlComment.substringData(Integer offset,
Integer count);
Параметры звонка:
- offset: Целое число, позиция первого возвращаемого символа
- count: Целое число, количество символов в подстроке, которые должны быть возвращены
Результат возврата:
- String, Вернуть извлеченную строку
appendData
Добавить строку в узел
1XmlComment.appendData(String arg);
Параметры звонка:
- arg: String, строка, добавляемая к узлу
insertData
Вставить строку в узел
1
2XmlComment.insertData(Integer offset,
String arg);
Параметры звонка:
- offset: Целое число, позиция символа, в которой строка должна быть вставлена в узел
- arg: String, строка, которую нужно вставить
deleteData
Удалить текст из узла
1
2XmlComment.deleteData(Integer offset,
Integer count);
Параметры звонка:
- offset: Целое число, позиция первого удаляемого символа
- count: Целое число, количество удаляемых символов
replaceData
Замените символы узла указанной строкой
1
2
3XmlComment.replaceData(Integer offset,
Integer count,
String arg);
Параметры звонка:
- offset: Целое число, позиция символа заменяемого узла
- count: Целое число, количество заменяемых символов
- arg: String, строка, которую нужно вставить
hasChildNodes
Запросить, есть ли дочерние узлы
1Boolean XmlComment.hasChildNodes();
Результат возврата:
- Boolean, Верните истину, если есть дочерние узлы, в противном случае верните ложь
normalize
Объединить смежные текстовые узлы и удалить пустые текстовые узлы
1XmlComment.normalize();
Этот метод будет проходить все узлы-потомки текущего узла и нормализовать документ, удаляя пустой узел Text и объединяя все смежные узлы Text. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.
cloneNode
Создать точную копию указанного узла
1XmlNode XmlComment.cloneNode(Boolean deep = true);
Параметры звонка:
- deep: Boolean, следует ли выполнять глубокое копирование; если true, клонированный узел будет клонировать все дочерние узлы исходного узла.
Результат возврата:
- XmlNode, Верните скопированный узел
Этот метод скопирует и вернет копию вызвавшего его узла. Если переданный ему параметр истинен, он также рекурсивно скопирует всех потомков текущего узла. В противном случае копируется только текущий узел. Возвращенный узел не принадлежит дереву документа, а его свойство parentNode имеет значение null. Когда узел Element копируется, все его атрибуты будут скопированы.
lookupPrefix
Возвращает префикс, соответствующий указанному URI пространства имен на текущем узле.
1String XmlComment.lookupPrefix(String namespaceURI);
Параметры звонка:
- namespaceURI: String, укажите соответствующий URI пространства имен
Результат возврата:
- String, Возвращает совпавший префикс, возвращает ноль, если он не совпадает
lookupNamespaceURI
Возвращает URI пространства имен, который соответствует указанному префиксу на текущем узле.
1String XmlComment.lookupNamespaceURI(String prefix);
Параметры звонка:
- prefix: String, укажите соответствующий префикс
Результат возврата:
- String, Возвращает соответствующий URI пространства имен, возвращает ноль, если он не совпадает
insertBefore
Вставьте новый дочерний узел перед существующим дочерним узлом
1
2XmlNode XmlComment.insertBefore(XmlNode newChild,
XmlNode refChild);
Параметры звонка:
Результат возврата:
- XmlNode, Верните новый дочерний узел
Если newChild уже существует в дереве документа, он будет удален из дерева, а затем снова вставлен в его новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. Другими словами, свойство ownerDocument у newChild должно быть таким же, как свойство ownerDocument текущего узла.
insertAfter
Вставьте новый дочерний узел после существующего дочернего узла
1
2XmlNode XmlComment.insertAfter(XmlNode newChild,
XmlNode refChild);
Параметры звонка:
Результат возврата:
- XmlNode, Верните новый дочерний узел
Если newChild уже существует в дереве документа, он будет удален из дерева, а затем снова вставлен в его новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. Другими словами, свойство ownerDocument у newChild должно быть таким же, как свойство ownerDocument текущего узла.
appendChild
Добавить новый дочерний узел в конец списка дочерних узлов узла
1XmlNode XmlComment.appendChild(XmlNode newChild);
Параметры звонка:
- newChild: XmlNode, Укажите добавленный узел
Результат возврата:
- XmlNode, Верните этот новый дочерний узел
Если newChild уже существует в дереве документа, он будет удален из дерева, а затем снова вставлен в его новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. Другими словами, свойство ownerDocument у newChild должно быть таким же, как свойство ownerDocument текущего узла.
replaceChild
Заменить один дочерний узел другим
1
2XmlNode XmlComment.replaceChild(XmlNode newChild,
XmlNode oldChild);
Параметры звонка:
Результат возврата:
- XmlNode, Если замена прошла успешно, этот метод может вернуть замененный узел, если замена не удалась, он возвращает ноль
Если newChild уже существует в дереве документа, он будет удален из дерева, а затем снова вставлен в его новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. Другими словами, свойство ownerDocument у newChild должно быть таким же, как свойство ownerDocument текущего узла.
removeChild
Удалить узел из списка дочерних узлов
1XmlNode XmlComment.removeChild(XmlNode oldChild);
Параметры звонка:
- oldChild: XmlNode, Укажите узел, который нужно удалить
Результат возврата:
- XmlNode, Если удаление прошло успешно, этот метод может вернуть удаленный узел, в случае неудачи - нуль
toString
Возвращает строковое представление объекта, обычно возвращает «[Native Object]», объект может быть повторно реализован в соответствии с его собственными характеристиками.
1String XmlComment.toString();
Результат возврата:
- String, Возвращает строковое представление объекта
toJSON
Возвращает представление объекта в формате JSON, обычно возвращает набор читаемых атрибутов, определенных объектом.
1Value XmlComment.toJSON(String key = "");
Параметры звонка:
- key: Строка, не используется
Результат возврата:
- Value, Возвращает значение, содержащее сериализуемый JSON