Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

matlab.io.xml.dom.Document 类

包: matlab.io.xml.dom

XML 文档

说明

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 中推出