XmlDocument.InsertBefore(IXmlNode, IXmlNode) 方法

定義

命名空間:

Windows.Data.Xml.Dom

將子節點插入指定節點的左邊，或插入子節點清單的結尾。

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 節點重新插入之前先移除它。 無法在 newChild 參數中傳遞唯讀節點，例如NODE_DOCUMENT_TYPE和NODE_ENTITY節點。

referenceChild

IXmlNode

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

傳回

IXmlNode

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

實作

InsertBefore(IXmlNode, IXmlNode)