XMLDOM對像方法:Document對像方法

- 中國WEB開發者網絡 (http://www.webasp.net)
-- 技術教程 (http://www.webasp.net/article/)
--- XMLDOM對像方法:Document對像方法 (http://www.webasp.net/article/18/17766.htm)
-- 作者:未知
-- 發佈日期: 2005-04-20
 

abort 方法

 作   用

 abort 方法取消一個進行中的異步下載

 基本語法

 xmlDocument.abort();

說   明

 如果這個方法在異步下載時被呼叫,所有的解析動作會停止,而且在內存中的文件會被釋放。

范   例

xmlDocument

AppendChild 方法

 作   用

 加上一個節點當作指定節點最後的子節點。

 基本語法

 xmlDocumentNode.appendChild(newChild);

說   明

 newChild 是附加子節點的地址。

范   例

docObj = xmlDoc.documentElement;
alert(docObj.xml);
objNewNode = docObj.appendChild(xmlDoc.documentElement. firstChild);
alert(docObj.xml);

cloneNode 方法

 作   用

 基本語法

 xmlDocumentNode.cloneNode(deep);

說   明

 deep 是一個布爾值。如果為true,此節點會複製以指定節點發展出去的所有節點。如果是false,只有指定的節點和它的屬性被複製。

范   例

currNode = xmlDoc.documentElement.childNodes.item(1);
objClonedNode = currNode.cloneNode(1);
alert(objClonedNode.xml);

createAttribute 方法

 作   用

 建立一個指定名稱的屬性。

 基本語法

 xmlDocument.createAttribute(name);

說   明

 name 是被建立屬性的名稱。

范   例

objNewAtt = xmlDoc.createAttribute("encryption");
alert(objNewAtt.xml);

createCDATASection 方法

 作   用

 基本語法

 xmlDocument.createCDATASection(data);

說   明

 date 是一個字符串,且包含了被置放在CDATA 的資料。

范   例

objNewCDATA = xmlDoc.createCDATASection("This is a CDATA Section");
alert(objNewCDATA.xml);

createComment 方法

 作   用

 基本語法

 xmlDocument.createComment(data);

說   明

 data 是一個字符串,且包含了被置放在批注的資料。

范   例

objNewComment = xmlDoc.createComment("This is a comment");
alert(objNewComment.xml);

createDocumentFragment 方法

 作   用

 建立一個空的文件片斷對象。

 基本語法

 xmlDocument.createDocumentFragment();

說   明

 一個新的文件片斷被建立,但沒有加到文件樹中。要加入片斷到文件樹中,必須使用插入方法,例如insertBefore、replaceChild 或appendChild。

范   例

objNewFragment = xmlDoc.createDocumentFragment();
alert(objNewFragment.xml);

createElement 方法

 作   用

 建立一個指定名稱的元素。

 基本語法

 xmlDocument.createElement(tagName);

說   明

 tagName 是一個區分大小寫的字符串來指定新元素名稱。

范   例

objNewElement = xmlDoc.createElement("TO");
alert(objNewElement.xml);

createEntityReference 方法

 作   用

 建立一個參照到指定名稱的實體。

 基本語法

 xmlDocument.createEntityReference(name);

說   明

 name 是一個區分大小寫的字符串,來指定新實體參照的名稱。一個新的實體參照被建立,但是並沒有被加到文件樹中。若要將實體參照加到文件樹中,必須使用一種插入方法,例如:insertBefore,replaceChild,或appendChild。

范   例

objNewER = xmlDoc.createEntityReference("eRef");
alert(objNewER.xml);

createNode 方法

 作   用

 建立一個指定型態、名稱,及命名空間的新節點。

 基本語法

 xmlDocument.createNode(type, name, nameSpaceURI);

說   明

 type 用來確認要被建立的節點型態,name 是一個字符串來確認新節點的名稱,命名空間的前綴則是選擇性的。nameSpaceURI 是一個定義命名空間URI 的字符串。如果前綴被包含在名稱參數中,此節點會在nameSpaceURI 的內文中以指定的前綴建立。如果不包含前綴,指定的命名空間會被視為預設的命名空間。

范   例

objNewNode = xmlDoc.createNode(1, "TO", "");
alert(objNewNode.xml);

createProcessingInstruction 方法

 作   用

 建立一個新的處理指令,包含了指定的目標和數據。

 基本語法

 xmlDocument.createProcessingInstruction(target, data);

說   明

 target 是表示目標、名稱或處理指令的字符串。Data 是表示處理指令的值。一個新的處理指令被建立,但是並沒有加到文件樹中。要把處理指令加到文件樹中,必須使用插入方法,例如:insertBefore、replaceChild,或是appendChild。

范   例

objNewPI =xmlDoc.createProcessingInstruction(『XML』, 『version="1.0"』);
alert(objNewPI.xml);

createTextNode 方法

 作   用

 建立一個新的text 節點,並包含指定的數據。

 基本語法

 xmlDocument.createTextNode(data);

說   明

 data 是一個代表新text 節點的字符串。一個新的text 節點被建立,但是沒有加到文件樹中。若要將節點加到文件樹中,必須使用插入方法,例如:insertBefore,replaceChild或appendChild。

范   例

objNewTextNode = xmlDoc.createTextNode("This is a text node.");
alert(objNewTextNode.xml);

getElementsByTagName 方法

 作   用

 傳回指定名稱的元素集合。

 基本語法

 objNodeList = xmlDocument.getElementsByTagName(tagname);

說   明

 tagname 是一個字符串,代表找到的元素卷標名稱。使用tagname "*"傳回文件中所有找到的元素。

范   例

objNodeList = xmlDoc.getElementsByTagName("*");
alert(objNodeList.item(1).xml);

haschildnodes 方法

 作   用

 如果指定的節點有一個或更多子節點,傳回值為true。

 基本語法

 boolValue = xmlDocumentNode.hasChildNodes() ;

說   明

 如果此節點有子節點傳回值為true,否則傳回false 值。

范   例

boolValue = xmlDoc.documentElement.hasChildNodes();
alert(boolValue);

insertBefore 方法

 作   用

 在指定的節點前插入一個子節點。

 基本語法

 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);

load 方法

 作   用

 表示從指定位置加載的文件。

 基本語法

 boolValue = xmlDocument.load(url);

說   明

 url 包含要被加載檔案的URL 的字符串。假如文件加載成功,傳回值即為true。若加載失敗,傳回值為false。

范   例

boolValue = xmlDoc.load("LstA_1.xml");
alert(boolValue);

loadXML 方法

 作   用

 加載一個XML 文件或字符串的片斷。

 基本語法

 boolValue = xmlDocument.loadXML(xmlString);

說   明

 xmlString 是包含XML 文字碼的字符串。

范   例

xmlString = "<GREETING><MESSAGE>Hello!</MESSAGE></GREETING>";
boolValue = xmlDoc.loadXML(xmlString);
alert(boolValue);

nodeFromID 方法

 作   用

 傳回節點ID 符合指定值的節點。

 基本語法

 xmlDocumentNode = xmlDocument.nodeFromID(idString);

說   明

 idString 是一個包含ID 值的字符串。符合的節點必定是ID 型態。若符合,將傳回一個對像;若操作失敗,則傳回null。

范   例

objDocumentNode = xmlDoc.nodeFromID("TO");
alert(objDocumentNode);

parsed 方法

 作   用

 會驗證該指定的節點(node)及其衍生的子節點(descendants)是否已被解析過。

 基本語法

 boolValue = xmlDocumentNode.parsed();

說   明

 如果全部的節點都已經被解析過了,則傳回值為ture;如果有任何一個節點尚未被解析,傳回值則為false。

范   例

currNode = xmlDoc.documentElement.childNodes.item(0);
boolValue = currNode.parsed();
alert(boolValue);

removeChild 方法

 作   用

 會將指定的節點從節點清單中移除。

 基本語法

 objDocumentNode = xmlDocumentNode.removeChild(oldChild);

說   明

 oldChild 為一個包含要被移除的節點對象。

范   例

objRemoveNode = xmlDoc.documentElement.childNodes.item(3);
alert(xmlDoc.xml);
xmlDoc.documentElement.removeChild(objRemoveNode);
alert(xmlDoc.xml);

replaceChild 方法

 作   用

 置換指定的舊子節點為提供的新子節點。

 基本語法

 objDocumentNode = xmlDocumentNode.replaceChild(newChild,oldChild);

說   明

 newChild 為包含新子節點的對象。如果此參數為null,則此舊子節點會被移除而不會被取代。oldChild 為包含舊子節點的對象。

范   例

objOldNode = xmlDoc.documentElement.childNodes.item(3);
objNewNode = xmlDoc.createComment("I've replaced the BCC element.");
alert(xmlDoc.xml);
xmlDoc.documentElement.replaceChild(objNewNode,objOldNode);
alert(xmlDoc.xml);

selectNodes 方法

 作   用

 傳回所有符合提供樣式(pattern)的節點。

 基本語法

 objDocumentNodeList = xmlDocumentNode.selectNodes(patternString);

說   明

 patternString 為一包含XSL 樣式的字符串。此方法會傳回節點清單對象,包含符合樣式的節點。如果沒有符合的節點,則傳回空的清單列表。

范   例

objNodeList=xmlDoc.selectNodes("/");
alert(objNodeList.item(0).xml);

selectSingleNode 傳回第一個符合樣式的節點。

 作   用

 傳回第一個符合樣式的節點。

 基本語法

 objDocumentNode = xmlDocumentNode.selectSingleNode(patternString);

說   明

 patternString 為一包含XSL 樣式的字符串。此方法會傳回第一個符合的節點對象,如果沒有符合的節點,則傳回null。

范   例

objNode = xmlDoc.selectSingleNode("EMAIL/BCC");
alert(objNode.xml);

transformNode 方法

 作   用

 使用提供的樣式表來處理該節點及其子節點。

 基本語法

 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);


webasp.net