matlab.io.xml.dom.DocumentFragment class

Пакет: matlab.io.xml.dom

Группа узлов документа

Описание

Используйте объект matlab.io.xml.dom.DocumentFragment класс как контейнер для группы узлов документа. Добавление фрагмента документа к другому узлу добавляет дочерние элементы фрагмента, но не самого фрагмента. Точно так же вставка фрагмента вводит дочерние элементы, но не фрагмент. Фрагмент не должен быть правильно построенным XML. Например, фрагмент может содержать несколько узлов верхнего уровня или один текстовый узел.

matlab.io.xml.dom.DocumentFragment классом является handle класс.

Атрибуты класса

`ConstructOnLoad`	`true`
`HandleCompatible`	`true`

Для получения информации об атрибутах класса см. Атрибуты класса.

Создание

Можно создать matlab.io.xml.dom.DocumentFragment объект при помощи createDocumentFragment метод matlab.io.xml.dom.Document объект.

Свойства

развернуть все

`TextContent` — Текстовое содержимое фрагмента документа
`''` (значение по умолчанию) | вектор символов | строковый скаляр

Текстовое содержимое этого фрагмента документа в виде вектора символов или строкового скаляра. Это свойство содержит конкатенированное текстовое содержимое дочерних элементов этого фрагмента.

Атрибуты:

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

Методы

развернуть все

Открытые методы

`appendChild`	`childNode = appendChild(thisFragment,childNode)` добавляет узел к этому фрагменту и возвращает добавленный объект узла.
`child`	`node = child(thisFragment,index)` возвращает дочерний элемент этого фрагмента в заданном индексе на основе одном. Значение индекса 1 задает первый дочерний элемент, значение 2 задает второй дочерний элемент и так далее.
`cloneNode`	`docClone = cloneNode(thisFragment,deep)` создает и возвращает копию этого `matlab.io.xml.dom.DocumentFragment` объект. Если `deep` `true`, копия является глубокой копией. Если `deep` `false`, копия является мелкой копией.
`compareDocumentPosition`	`posEnum = compareDocumentPosition(thisFragment,otherNode)` возвращается 35, который указывает, что этот фрагмент не имеет никакого отношения к позиции другого узла в документе. Фрагмент документа не имеет никакого отношения к другим узлам документа, потому что фрагмент никогда не является дочерним элементом документа.
`getAttributes`	`attrs = getAttributes(thisFragment)` возвращает пустой `matlab.io.xml.dom.NamedNodeMap` возразите, потому что фрагменты документа не имеют атрибутов.
`getChildNodes`	`nodeList = getChildNodes(thisFragment)` возвращает дочерние элементы этого фрагмента как `matlab.io.xml.dom.NodeList` объект.
`getChildren`	`nodes = getChildren(thisFragment)` возвращает 1 N массивом объектов, таких как `matlab.io.xml.dom.Element` или `matlab.io.xml.dom.Text` объекты, которые представляют дочерние элементы этого фрагмента.
`getFirstChild`	`child = getFirstChild(thisFragment)` возвращает первый дочерний элемент этого фрагмента.
`getLastChild`	`child = getLastChild(thisFragment)` возвращает последний дочерний элемент этого фрагмента.
`getLength`	`length = getLength(thisFragment)` возвращает количество дочерних элементов этого фрагмента как двойное.
`getLocalName`	`name = getLocalName(thisFragment)` возвращает пустой символьный массив, потому что фрагменты документа не имеют имен.
`getNamespaceURI`	`uri = getNamespaceURI(thisFragment)` возвращает пустой символьный массив, потому что фрагменты документа не имеют имен.
`getNextSibling`	`getNextSibling(thisFragment)` возвращает пустой объект узла, потому что фрагменты не могут иметь одноуровневых элементов.
`getNodeName`	`name = getNodeName(thisFragment)` returns `'#document-fragment'`, который является именем узла фрагмента документа, заданного стандартом W3C XML DOM.
`getNodeType`	`type = getNodeType(thisFragment)` возвращает двойной `11`, который указывает, что этот узел является фрагментом документа. Этот метод предоставляет совместимости с существующим MATLAB^® код, который основан на стандарте W3C XML DOM. Для нового кода MATLAB использовать `isa` определить тип узла. Например: import matlab.io.xml.dom.* d = Document('book'); frag= createDocumentFragment(d); if isa(frag,'matlab.io.xml.dom.DocumentFragment') fprintf('This is an document fragment.\n'); end
`getNodeValue`	`name = getNodeValue(thisFragment)` возвращает пустой символьный вектор, потому что фрагмент не имеет значения узла.
`getOwnerDocument`	`doc = getOwnerDocument(thisFragment)` возвращает документ, который владеет этим элементом как `matlab.io.xml.dom.Document` объект. Документ владельца является документом, который создал этот фрагмент.
`getParentNode`	`parent = getParentNode(thisFragment)` возвращает пустой объект узла, потому что фрагменты документа не имеют родительских элементов.
`getPrefix`	`prefix = getPrefix(thisFragment)` возвращает пустой символьный вектор, потому что фрагменты не имеют имен.
`getPreviousSibling`	`getPreviousSibling(thisFragment)` возвращает пустой объект узла, потому что фрагменты документа не имеют одноуровневых элементов.
`getTextContent`	`getTextContent(thisFragment)` возвращает текстовое содержимое этого фрагмента. Если этот фрагмент имеет дочерние элементы, метод возвращает конкатенированное текстовое содержимое дочерних элементов.
`hasAttributes`	`tf = hasAttributes(thisFragment)` возвращает `false` потому что фрагмент не имеет атрибутов.
`hasChildNodes`	`tf = hasChildNodes(thisFragment)` возвращает `true` если этот фрагмент имеет дочерние элементы.
`insertBefore`	`node = insertBefore(thisFragment,newChild,refChild)` вставляет `newChild` перед `refChild` в этом фрагменте документа. Если `refChild` пусто, метод вставляет `newChild` в конце списка дочерних элементов этого фрагмента. Если `newChild` узел фрагмента документа, метод вводит дочерние элементы фрагмента перед ссылочным узлом в том же порядке, как они появляются во фрагменте. Если `newChild` уже существует во фрагменте, метод удаляет и повторно вставляет его. Если `refChild` узел, который никогда не добавлялся или вставлялся во фрагмент, это обработано как пустой объект и `newChild` вставляется в конце списка дочерних элементов этого фрагмента.
`isDefaultNamespace`	`tf = isDefaultNamespace(thisFragment,namespaceURI)` возвращает `false` потому что фрагменты документа не имеют имен.
`isEqualNode`	`tf = isEqualNode(thisFragment,otherNode)` возвращает `true` если узел задан `otherNode` фрагмент, и дочерние элементы этого фрагмента и другого узла фрагмента равны. Этот метод тестирует на равенство узлов, не, являются ли узлы указателями на тот же объект. Чтобы протестировать на сходство, используйте `isSameNode` метод. Узлы, которые являются тем же самым, также равны, но узлы, которые равны, являются не обязательно тем же самым.
`isSameNode`	`tf = isSameNode(thisFragment,otherNode)` возвращает `true` если `otherNode` тот же узел как `thisFragment`.
`item`	`node = item(thisFragment,index)` возвращает дочерний элемент этого фрагмента, заданного основанным на нуле индексом. Значение индекса 0 задает первый дочерний элемент, значение 1 задает второй дочерний элемент и так далее.
`lookupNamespaceURI`	`uri = lookupNamespaceURI(thisFragment,prefix)` возвращает пустой символьный массив, потому что фрагменты документа не имеют пространств имен.
`lookupPrefix`	`prefix = lookupPrefix(thisFragment,namespaceURI)` возвращает пустой символьный вектор, потому что фрагменты не имеют имен.
`normalize`	`normalize(thisFragment)` удаляет пустые текстовые узлы из этого фрагмента и комбинирует смежные текстовые узлы в один текстовый узел.
`removeChild`	`child = removeChild(thisFragment,child)` удаляет дочерний узел, заданный `child` от этого фрагмента и возвращает удаленный дочерний элемент.
`replaceChild`	`child = replaceChild(thisFragment,newChild,oldChild)` замены `oldChild` с `newChild` и возвращает `newChild`. Если `newChild` `matlab.io.dom.xml.DocumentFragment` объект, метод заменяет `oldChild` со всеми дочерними элементами `DocumentFragment` возразите и вводит дочерние элементы в тот же порядок. Если новый дочерний элемент уже находится во фрагменте, метод удаляет дочерний элемент из документа, прежде чем это заменит старый дочерний элемент.
`setNodeValue`	`setNodeValue(thisFragment,value)` не изменяет значение узла этого фрагмента. Значением узла фрагмента является `''`по определению.
`setPrefix`	`setPrefix(thisFragment,prefix)` возвращает ошибку, потому что фрагменты документа не имеют имен.
`setTextContent`	`setTextContent(thisFragment,textContent)` заменяет существующие узлы в этом фрагменте с `matlab.io.xml.dom.Text` узел, который содержит заданный текст. Задайте `textContent` как вектор символов или строковый скаляр.

Примеры

свернуть все

Используйте фрагмент документа, чтобы создать на основе содержимого на данных во время выполнения

Скрипт Open Live Script

Предположим, что ваше приложение создает главы и что количество глав определяется во время выполнения. Можно записать функцию, такую как createChapters функция, заданная в конце этого примера, чтобы создать конкретное количество элементов главы и возвратить их как фрагмент документа.

Создайте документ, который имеет корневой элемент под названием book.

import matlab.io.xml.dom.*

doc = Document("book");
docElemRoot = getDocumentElement(doc);

Вызовите функциональный createChapters возвратить три главы как matlab.io.xml.dom.DocumentFragment объект. Добавьте фрагмент к документу.

docFrag = createChapters(doc,3);
appendChild(docElemRoot,docFrag);

Запишите документ файлу book.xml.

xmlFileName = "book.xml";
writer = matlab.io.xml.dom.DOMWriter;
writeToFile(writer,doc,xmlFileName);

Отобразите получившийся XML.

type(xmlFileName);

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book [
<!ENTITY chapter SYSTEM "chapter.xml">
]>
<book>
    &chapter;
</book>

createChapters Функция

Функциональный createChapters возвращает DocumentFragment объект, который содержит конкретное количество элементов главы.

function docFrag = createChapters(doc,n)
docFrag = createDocumentFragment(doc);
for i=1:n
    chapter = createElement(doc,"chapter");
    appendChild(chapter,createTextNode(doc,sprintf("Chapter %d",i)));
    appendChild(docFrag,chapter);
end
end

Введенный в R2021a

Документация

matlab.io.xml.dom.DocumentFragment class

Описание

Атрибуты класса

Создание

Свойства

`TextContent` — Текстовое содержимое фрагмента документа
`''` (значение по умолчанию) | вектор символов | строковый скаляр

Атрибуты:

Методы

Открытые методы

Примеры

Используйте фрагмент документа, чтобы создать на основе содержимого на данных во время выполнения

Смотрите также

Документация MATLAB

Поддержка

Документация

matlab.io.xml.dom.DocumentFragment class

Описание

Атрибуты класса

Создание

Свойства

TextContent — Текстовое содержимое фрагмента документа '' (значение по умолчанию) | вектор символов | строковый скаляр

Атрибуты:

Методы

Открытые методы

Примеры

Используйте фрагмент документа, чтобы создать на основе содержимого на данных во время выполнения

Смотрите также

Документация MATLAB

Поддержка

`TextContent` — Текстовое содержимое фрагмента документа
`''` (значение по умолчанию) | вектор символов | строковый скаляр