对象 XmlCDATASection

XmlCDATASection 对象表示文档中的 CDATA 区段

XmlCDATASection 接口是 XmlText 接口的子接口,没有定义任何自己的属性和方法。通过从 XmlNode 接口继承 nodeValue 属性,或通过从 XmlCharacterData 接口继承 data 属性,可以访问 CDATA Section 的文本内容。

虽然通常可以把 XmlCDATASection 节点作为 XmlText 节点处理,但要注意 XmlNode 的 normalize 方法不并入相邻的 CDATA 部分。

使用 XmlDocument 的 createXmlCDATASection 方法来创建一个 XmlCDATASection 。

CDATA 区段包含了不会被解析器解析的文本。CDATA 区段中的标签不会被视为标记,同时实体也不会被展开。主要的目的是为了包含诸如 XML 片段之类的材料,而无需转义所有的分隔符。

在一个 CDATA 中唯一被识别的分隔符是 "]]>",它可标示 CDATA 区段的结束。CDATA 区段不能进行嵌套。

继承关系

成员属性

data

String, 该节点包含的文本

String XmlCDATASection.data;

length

Integer, 该节点包含的字符数

readonly Integer XmlCDATASection.length;

nodeType

Integer, 返回节点的节点类型

readonly Integer XmlCDATASection.nodeType;

不同对象的 nodeType 会返回不同的值:


nodeName

String, 返回节点的名称,根据其类型

readonly String XmlCDATASection.nodeName;

不同对象的 nodeName 会返回不同的值:


nodeValue

String, 返回节点的名称,根据其类型

String XmlCDATASection.nodeValue;

不同对象的 nodeName 会返回不同的值:


ownerDocument

XmlDocument, 返回节点的根元素(XmlDocument 对象)

readonly XmlDocument XmlCDATASection.ownerDocument;

parentNode

XmlNode, 可返回某节点的父节点

readonly XmlNode XmlCDATASection.parentNode;

childNodes

XmlNodeList, 返回指定节点的子节点的节点列表

readonly XmlNodeList XmlCDATASection.childNodes;

firstChild

XmlNode, 返回节点的首个子节点

readonly XmlNode XmlCDATASection.firstChild;

lastChild

XmlNode, 返回节点的最后一个子节点

readonly XmlNode XmlCDATASection.lastChild;

previousSibling

XmlNode, 返回某节点之前紧跟的节点(处于同一树层级),如果没有此节点,那么该属性返回 null

readonly XmlNode XmlCDATASection.previousSibling;

nextSibling

XmlNode, 返回某个元素之后紧跟的节点(处于同一树层级中),如果无此节点,则属性返回 null

readonly XmlNode XmlCDATASection.nextSibling;

成员函数

splitText

按照指定的 offset 把文本节点分割为两个节点

XmlText XmlCDATASection.splitText(Integer offset);

调用参数:

返回结果:

该方法将在指定的 offset 处把 XmlText 节点分割成两个节点。原始的 XmlText 节点将被修改,使它包含 offset 指定的位置之前的文本内容(但不包括文本内容)。新的 XmlText 节点将被创建,用于存放从 offset 位置(包括该位置上的字符)到原字符结尾的所有字符。新的 XmlText 节点是该方法的返回值。此外,如果原始的 XmlText 节点具有 parentNode,新的 XmlText 节点将插入这个父节点,紧邻在原始节点之后。

XmlCDATASection 接口继承了 XmlText 接口, XmlCDATASection 节点也可以使用该方法 ,只是新创建的节点是 XmlCDATASection 节点,而不是 XmlText 节点。


substringData

从节点中提取子串

String XmlCDATASection.substringData(Integer offset,
    Integer count);

调用参数:

返回结果:


appendData

把字符串附加到节点上

XmlCDATASection.appendData(String arg);

调用参数:


insertData

把字符串插入节点

XmlCDATASection.insertData(Integer offset,
    String arg);

调用参数:


deleteData

从节点删除文本

XmlCDATASection.deleteData(Integer offset,
    Integer count);

调用参数:


replaceData

用指定的字符串替换节点的字符

XmlCDATASection.replaceData(Integer offset,
    Integer count,
    String arg);

调用参数:


hasChildNodes

查询是否存在子节点

Boolean XmlCDATASection.hasChildNodes();

返回结果:


normalize

合并相邻的 Text 节点并删除空的 Text 节点

XmlCDATASection.normalize();

这个方法将遍历当前节点的所有子孙节点,通过删除空的 Text 节点,已经合并所有相邻的 Text 节点来规范化文档。该方法在进行节点的插入或删除操作后,对于简化文档树的结构很有用。


cloneNode

创建指定的节点的精确拷贝

XmlNode XmlCDATASection.cloneNode(Boolean deep = true);

调用参数:

返回结果:

该方法将复制并返回调用它的节点的副本。如果传递给它的参数是 true,它还将递归复制当前节点的所有子孙节点。 否则,它只复制当前节点。返回的节点不属于文档树,它的 parentNode 属性为 null。当复制的是 Element 节点时,它的所有属性都将被复制。


lookupPrefix

返回在当前节点上匹配指定的命名空间 URI 的前缀

String XmlCDATASection.lookupPrefix(String namespaceURI);

调用参数:

返回结果:


lookupNamespaceURI

返回在当前节点上匹配指定的前缀的命名空间 URI

String XmlCDATASection.lookupNamespaceURI(String prefix);

调用参数:

返回结果:


insertBefore

在已有的子节点前插入一个新的子节点

XmlNode XmlCDATASection.insertBefore(XmlNode newChild,
    XmlNode refChild);

调用参数:

返回结果:

如果文档树中已经存在了 newChild,它将从文档树中删除,然后重新插入它的新位置。来自一个文档的节点(或由一个文档创建的节点)不能插入另一个文档。也就是说,newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。


insertAfter

在已有的子节点后插入一个新的子节点

XmlNode XmlCDATASection.insertAfter(XmlNode newChild,
    XmlNode refChild);

调用参数:

返回结果:

如果文档树中已经存在了 newChild,它将从文档树中删除,然后重新插入它的新位置。来自一个文档的节点(或由一个文档创建的节点)不能插入另一个文档。也就是说,newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。


appendChild

向节点的子节点列表的末尾添加新的子节点

XmlNode XmlCDATASection.appendChild(XmlNode newChild);

调用参数:

返回结果:

如果文档树中已经存在了 newChild,它将从文档树中删除,然后重新插入它的新位置。来自一个文档的节点(或由一个文档创建的节点)不能插入另一个文档。也就是说,newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。


replaceChild

将某个子节点替换为另一个

XmlNode XmlCDATASection.replaceChild(XmlNode newChild,
    XmlNode oldChild);

调用参数:

返回结果:

如果文档树中已经存在了 newChild,它将从文档树中删除,然后重新插入它的新位置。来自一个文档的节点(或由一个文档创建的节点)不能插入另一个文档。也就是说,newChild 的 ownerDocument 属性必须与当前节点的 ownerDocument 属性相同。


removeChild

从子节点列表中删除某个节点

XmlNode XmlCDATASection.removeChild(XmlNode oldChild);

调用参数:

返回结果:


dispose

强制回收对象,调用此方法后,对象资源将立即释放

XmlCDATASection.dispose();

equals

比较当前对象与给定的对象是否相等

Boolean XmlCDATASection.equals(object expected);

调用参数:

返回结果:


toString

返回对象的字符串表示,一般返回 "[Native Object]",对象可以根据自己的特性重新实现

String XmlCDATASection.toString();

返回结果:


toJSON

返回对象的 JSON 格式表示,一般返回对象定义的可读属性集合

Value XmlCDATASection.toJSON(String key = "");

调用参数:

返回结果:


valueOf

返回对象本身的数值

Value XmlCDATASection.valueOf();

返回结果: