Объект XmlComment

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

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

использовать XmlDocument.createComment() для создания объекта комментария.

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

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

data

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

1
String XmlComment.data;

---

length

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

1
readonly Integer XmlComment.length;

---

nodeType

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

1
readonly 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, возвращает имя узла в соответствии с его типом

1
readonly String XmlComment.nodeName;

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

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

---

nodeValue

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

1
String XmlComment.nodeValue;

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

• XmlElement: нулевой
• XmlAttr: Значение атрибута
• XmlText: Содержимое узла
• XmlCDATASection: Содержимое узла
• XmlProcessingInstruction: Вернуть указанные данные содержимого
• XmlComment: Текст комментария
• XmlDocument: нулевой
• XmlDocumentType: нулевой

---

ownerDocument

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

1
readonly XmlDocument XmlComment.ownerDocument;

---

parentNode

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

1
readonly XmlNode XmlComment.parentNode;

---

childNodes

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

1
readonly XmlNodeList XmlComment.childNodes;

---

firstChild

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

1
readonly XmlNode XmlComment.firstChild;

---

lastChild

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

1
readonly XmlNode XmlComment.lastChild;

---

previousSibling

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

1
readonly XmlNode XmlComment.previousSibling;

---

nextSibling

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

1
readonly XmlNode XmlComment.nextSibling;

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

substringData

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

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

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

• offset: Целое число, позиция первого возвращаемого символа
• count: Целое число, количество символов в подстроке, которые должны быть возвращены

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

• String, Вернуть извлеченную строку

---

appendData

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

1
XmlComment.appendData(String arg);

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

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

---

insertData

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

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

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

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

---

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: String, строка, которую нужно вставить

---

hasChildNodes

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

1
Boolean XmlComment.hasChildNodes();

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

• Boolean, Верните истину, если есть дочерние узлы, в противном случае верните ложь

---

normalize

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

1
XmlComment.normalize();

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

---

cloneNode

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

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

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

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

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

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

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

---

lookupPrefix

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

1
String XmlComment.lookupPrefix(String namespaceURI);

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

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

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

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

---

lookupNamespaceURI

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

1
String XmlComment.lookupNamespaceURI(String prefix);

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

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

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

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

---

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, Верните новый дочерний узел

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

---

appendChild

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

1
XmlNode XmlComment.appendChild(XmlNode newChild);

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

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

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

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

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

---

replaceChild

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

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

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

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

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

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

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

---

removeChild

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

1
XmlNode XmlComment.removeChild(XmlNode oldChild);

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

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

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

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

---

toString

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

1
String XmlComment.toString();

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

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

---

toJSON

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

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

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

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

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

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