Main Content

matlab.io.xml.dom.Document 类

命名空间: matlab.io.xml.dom

XML 文档

自 R2021a 起

描述

matlab.io.xml.dom.Document 类的一个对象,表示 XML 文档。要创建一个 XML 文档,您需要创建一个 Document 对象。如果使用 matlab.io.xml.dom.Parser 对象读取 XML 文件,解析器将创建一个 Document 对象。

matlab.io.xml.dom.Document 类是一个 handle 类。

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息,请参阅类属性

创建对象

描述

doc = matlab.io.xml.dom.Document() 创建一个空文档。

doc = matlab.io.xml.dom.Document(docElemName) 使用具有指定名称的根元素创建文档。

根元素是 TagName 属性设置为 docElemNamematlab.io.xml.dom.Element 对象。

示例

doc = matlab.io.xml.dom.Document(docElemName,docTypeName,publicId,systemId) 还指定文档类型。

文档类型是一个 matlab.io.xml.dom.DocumentType 对象,其 Name 属性设置为 docTypeName,其 PublicID 属性设置为 publicID,其 SystemID 属性设置为 systemID

doc = matlab.io.xml.dom.Document(docElemNSURI,docElemQName) 创建具有特定根元素的文档,该根元素具有指定的命名空间统一资源标识符 (URI) 和限定名称。

doc = matlab.io.xml.dom.Document(docElemNSURI,docElemQName,docTypeName,publicId,systemId) 使用指定的根元素和文档类型创建文档,其中根元素位于指定的命名空间中。

输入参量

全部展开

根元素名,指定为字符向量或字符串标量。

文档类型定义 (DTD) 的名称,指定为字符向量或字符串标量。

文档类型公共标识符,指定为字符向量或字符串标量。

文档类型系统标识符,指定为字符向量或字符串标量。

根元素名称的命名空间统一资源标识符 (URI),指定为字符向量或字符串标量。

限定根元素名称,指定为字符向量或字符串标量。

属性

全部展开

此文档的子节点,指定为 matlab.io.xml.dom.Element 对象。

属性:

GetAccess
public
SetAccess
immutable
NonCopyable
true
Transient
true

用于解析此文档的源 XML 文件的字符编码,指定为字符向量。

示例: 'utf-8'

属性:

GetAccess
public
SetAccess
immutable
Transient
true
NonCopyable
true

由用于解析此文档的源 XML 文件中的 XML 声明定义的字符编码,指定为字符向量。

示例: 'utf-8'

属性:

GetAccess
public
SetAccess
immutable
Transient
true
NonCopyable
true

此文档是否为独立文档,指定为 truefalse。如果此值为 true,解析器将忽略 XML 中的文档类型定义 (DTD) 标记声明。如果此文档是从声明 XML 是独立文档的 XML 源创建的,解析器会将此属性设置为 true

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

此文档的 XML 版本,指定为字符向量。如果此文档是从声明 XML 版本的 XML 源创建的,则解析器会将此属性设置为指定的版本。

示例: '1.0'

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

文档源文件的统一资源标识符 (URI),指定为字符向量。如果此文档是从文件创建的,解析器会将此属性设置为指定文件位置的 URI。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

文档配置,指定为 matlab.io.xml.dom.DocumentConfiguration 对象,该对象指定用于标准化此文档的选项。

属性:

GetAccess
public
SetAccess
immutable
NonCopyable
true
Transient
true

方法

全部展开

示例

全部折叠

使用 XML 解析器从文件 days.xml 创建一个 Document 对象。

import matlab.io.xml.dom.*

doc = parseFile(Parser,"days.xml");

创建一个具有名为 weekdays 的根元素的文档。向根元素追加内容。

import matlab.io.xml.dom.*
doc = Document("weekdays");
docRootNode = getDocumentElement(doc);

weekdays = ["Mon" "Tue" "Wed" "Thu" "Fri"];
for i=1:5
    dayElement = createElement(doc,"day");
    appendChild(dayElement,createTextNode(doc,weekdays(i)));
    appendChild(docRootNode,dayElement);
end

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

版本历史记录

在 R2021a 中推出