XMLDOM对象方法：Document对象方法-XML教程,XML基础

 作   用

 基本语法

 xmldocument.abort();

说   明

 如果这个方法在异步下载时被呼叫，所有的解析动作会停止，而且在内存中的文件会被释放。

范   例

xmldocument

 作   用

 基本语法

 xmldocumentnode.appendchild(newchild);

说   明

 newchild 是附加子节点的地址。

范   例

docobj ＝ xmldoc.documentelement;
alert(docobj.xml);
objnewnode ＝ docobj.appendchild(xmldoc.documentelement. firstchild);
alert(docobj.xml);

 作   用

 基本语法

 xmldocumentnode.clonenode(deep);

说   明

 deep 是一个布尔值。如果为true，此节点会复制以指定节点发展出去的所有节点。如果是false，只有指定的节点和它的属性被复制。

范   例

currnode ＝ xmldoc.documentelement.childnodes.item(1);
objclonednode ＝ currnode.clonenode(1);
alert(objclonednode.xml);

 作   用

 基本语法

 xmldocument.createattribute(name);

说   明

 name 是被建立属性的名称。

范   例

objnewatt ＝ xmldoc.createattribute(“encryption”);
alert(objnewatt.xml);

 作   用

 基本语法

 xmldocument.createcdatasection(data);

说   明

 date 是一个字符串，且包含了被置放在cdata 的资料。

范   例

objnewcdata ＝ xmldoc.createcdatasection(“this is a cdata section”);
alert(objnewcdata.xml);

 作   用

 基本语法

 xmldocument.createcomment(data);

说   明

 data 是一个字符串，且包含了被置放在批注的资料。

范   例

objnewcomment ＝ xmldoc.createcomment(“this is a comment”);
alert(objnewcomment.xml);

 作   用

 基本语法

 xmldocument.createdocumentfragment();

说   明

 一个新的文件片断被建立，但没有加到文件树中。要加入片断到文件树中，必须使用插入方法，例如insertbefore、replacechild 或appendchild。

范   例

objnewfragment ＝ xmldoc.createdocumentfragment();
alert(objnewfragment.xml);

 作   用

 基本语法

 xmldocument.createelement(tagname);

说   明

 tagname 是一个区分大小写的字符串来指定新元素名称。

范   例

objnewelement ＝ xmldoc.createelement(“to”);
alert(objnewelement.xml);

 作   用

 基本语法

 xmldocument.createentityreference(name);

说   明

 name 是一个区分大小写的字符串，来指定新实体参照的名称。一个新的实体参照被建立，但是并没有被加到文件树中。若要将实体参照加到文件树中，必须使用一种插入方法，例如：insertbefore，replacechild，或appendchild。

范   例

objnewer ＝ xmldoc.createentityreference(“eref”);
alert(objnewer.xml);

 作   用

 基本语法

 xmldocument.createnode(type, name, namespaceuri);

说   明

 type 用来确认要被建立的节点型态，name 是一个字符串来确认新节点的名称，命名空间的前缀则是选择性的。namespaceuri 是一个定义命名空间uri 的字符串。如果前缀被包含在名称参数中，此节点会在namespaceuri 的内文中以指定的前缀建立。如果不包含前缀，指定的命名空间会被视为预设的命名空间。

范   例

objnewnode ＝ xmldoc.createnode(1, “to”, “”);
alert(objnewnode.xml);

 作   用

 基本语法

 xmldocument.createprocessinginstruction(target, data);

说   明

 target 是表示目标、名称或处理指令的字符串。data 是表示处理指令的值。一个新的处理指令被建立，但是并没有加到文件树中。要把处理指令加到文件树中，必须使用插入方法，例如：insertbefore、replacechild，或是appendchild。

范   例

objnewpi ＝xmldoc.createprocessinginstruction(‘xml’, ‘version＝”1.0″’);
alert(objnewpi.xml);

 作   用

 基本语法

 xmldocument.createtextnode(data);

说   明

 data 是一个代表新text 节点的字符串。一个新的text 节点被建立，但是没有加到文件树中。若要将节点加到文件树中，必须使用插入方法，例如：insertbefore，replacechild或appendchild。

范   例

objnewtextnode ＝ xmldoc.createtextnode(“this is a text node.”);
alert(objnewtextnode.xml);

 作   用

 基本语法

 objnodelist ＝ xmldocument.getelementsbytagname(tagname);

说   明

 tagname 是一个字符串，代表找到的元素卷标名称。使用tagname “*”传回文件中所有找到的元素。

范   例

objnodelist ＝ xmldoc.getelementsbytagname(“*”);
alert(objnodelist.item(1).xml);

 作   用

 基本语法

 boolvalue ＝ xmldocumentnode.haschildnodes() ;

说   明

 如果此节点有子节点传回值为true，否则传回false 值。

范   例

boolvalue ＝ xmldoc.documentelement.haschildnodes();
alert(boolvalue);

 作   用

 基本语法

 objdocumentnode ＝ xmldocumentnode.insertbefore(newchild,refchild);

说   明

 newchild 是一个包含新子节点地址的对象，refchild 是参照节点的地址。新子节点被插到参照节点之前。如果refchild 参数没有包含在内，新的子节点会被插到子节点列表的末端。

范   例

objrefnode ＝ xmldoc.documentelement;
alert(xmldoc.xml);
objnewnode ＝ xmldoc.createcomment(“this is a comment”);
xmldoc.insertbefore(objnewnode, objrefnode);
alert(xmldoc.xml);

 作   用

 基本语法

 boolvalue ＝ xmldocument.load(url);

说   明

 url 包含要被加载档案的url 的字符串。假如文件加载成功，传回值即为true。若加载失败，传回值为false。

范   例

boolvalue ＝ xmldoc.load(“lsta_1.xml”);
alert(boolvalue);

 作   用

 基本语法

 boolvalue ＝ xmldocument.loadxml(xmlstring);

说   明

 xmlstring 是包含xml 文字码的字符串。

范   例

xmlstring ＝ “<greeting><message>hello!</message></greeting>”;
boolvalue ＝ xmldoc.loadxml(xmlstring);
alert(boolvalue);

 作   用

 基本语法

 xmldocumentnode ＝ xmldocument.nodefromid(idstring);

说   明

 idstring 是一个包含id 值的字符串。符合的节点必定是id 型态。若符合，将传回一个对象；若操作失败，则传回null。

范   例

objdocumentnode ＝ xmldoc.nodefromid(“to”);
alert(objdocumentnode);

 作   用

 基本语法

 boolvalue ＝ xmldocumentnode.parsed()；

说   明

 如果全部的节点都已经被解析过了，则传回值为ture；如果有任何一个节点尚未被解析，传回值则为false。

范   例

currnode ＝ xmldoc.documentelement.childnodes.item(0)；
boolvalue ＝ currnode.parsed()；
alert(boolvalue)；

 作   用

 基本语法

 objdocumentnode ＝ xmldocumentnode.removechild(oldchild);

说   明

 oldchild 为一个包含要被移除的节点对象。

范   例

objremovenode ＝ xmldoc.documentelement.childnodes.item(3)；
alert(xmldoc.xml);
xmldoc.documentelement.removechild(objremovenode)；
alert(xmldoc.xml)；

 作   用

 基本语法

 objdocumentnode ＝ xmldocumentnode.replacechild(newchild,oldchild)；

说   明

 newchild 为包含新子节点的对象。如果此参数为null，则此旧子节点会被移除而不会被取代。oldchild 为包含旧子节点的对象。

范   例

objoldnode ＝ xmldoc.documentelement.childnodes.item(3)；
objnewnode ＝ xmldoc.createcomment(“ive replaced the bcc element.”)；
alert(xmldoc.xml)；
xmldoc.documentelement.replacechild(objnewnode,objoldnode)；
alert(xmldoc.xml)；

 作   用

 基本语法

 objdocumentnodelist ＝ xmldocumentnode.selectnodes(patternstring)；

说   明

 patternstring 为一包含xsl 样式的字符串。此方法会传回节点清单对象，包含符合样式的节点。如果没有符合的节点，则传回空的清单列表。

范   例

objnodelist＝xmldoc.selectnodes（”/”）；
alert（objnodelist.item(0).xml）；

 作   用

 基本语法

 objdocumentnode ＝ xmldocumentnode.selectsinglenode(patternstring)；

说   明

 patternstring 为一包含xsl 样式的字符串。此方法会传回第一个符合的节点对象，如果没有符合的节点，则传回null。

范   例

objnode ＝ xmldoc.selectsinglenode(“email/bcc”)；
alert(objnode.xml)；

 作   用

 基本语法

 strtransformeddocument ＝ xmldocumentnode.transformnode(stylesheet)；

说   明

 stylesheet 为一xml 文件或是片断包含负责节点转换工作的xsl 元素。此方法会传回一包含转换结果的字符串。

范   例

var style ＝ new activexobject(“microsoft.xmldom”)；
style.load(“lsta_49.xsl”)；
strtransform ＝ xmldoc.transformnode(style.documentelement)；
alert(strtransform)；