다음을 통해 공유


IXmlNode.InsertBefore(IXmlNode, IXmlNode) 메서드

정의

지정된 노드의 왼쪽 또는 목록 끝에 자식 노드를 삽입합니다.

public:
 IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild);
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이면 개체가 만들어지지 않습니다.

적용 대상