共用方式為


XmlCDataSection.InsertBefore(IXmlNode, IXmlNode) 方法

定義

將子節點插入指定節點左邊,或在子節點清單的結尾。 這個方法不適用於這個類別,而且會擲回例外狀況。

public:
 virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;
IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);
public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);
function insertBefore(newChild, referenceChild)
Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNode

參數

newChild
IXmlNode

要插入新節點的位址。 這裡傳遞的節點必須是目前的 XML DOM 文件節點的有效子系。 例如,如果目前的節點是屬性,則您無法在 newChild 參數中傳遞另一個屬性,因為屬性不能有屬性做為子系。 如果 newChild 是DOCUMENT_FRAGMENT節點類型,則其所有子系都會依序插入 referenceChild之前。

如果 newChild 已經在樹狀結構中,則會先將其移除,再重新插入 referenceChild 節點之前。 唯讀節點,例如NODE_DOCUMENT_TYPE和NODE_ENTITY節點,無法在 newChild 參數中傳遞。

referenceChild
IXmlNode

參考節點。 指定的節點是 newChild 節點要插入左邊做為子清單中的上一個同層級的位置。 這裡傳遞的節點必須是目前節點的子節點或 Null。 如果值為 Null,就會在子清單結尾插入 newChild 節點。 如果 referenceChild 節點不是目前節點的子節點,則會傳回錯誤。

傳回

成功則為插入的子節點。 如果為 null,則不會建立任何物件。

實作

適用於