XmlNode.InsertBefore 메서드

아티클
08/21/2007

지정된 노드를 지정된 참조 노드 바로 앞에 삽입합니다.

네임스페이스: System.Xml
어셈블리: System.Xml(system.xml.dll)

구문

‘선언
Public Overridable Function InsertBefore ( _
    newChild As XmlNode, _
    refChild As XmlNode _
) As XmlNode
‘사용 방법
Dim instance As XmlNode
Dim newChild As XmlNode
Dim refChild As XmlNode
Dim returnValue As XmlNode

returnValue = instance.InsertBefore(newChild, refChild)

public virtual XmlNode InsertBefore (
    XmlNode newChild,
    XmlNode refChild
)

public:
virtual XmlNode^ InsertBefore (
    XmlNode^ newChild, 
    XmlNode^ refChild
)

public XmlNode InsertBefore (
    XmlNode newChild, 
    XmlNode refChild
)

public function InsertBefore (
    newChild : XmlNode, 
    refChild : XmlNode
) : XmlNode

매개 변수

newChild
삽입할 XmlNode입니다.

refChild
참조 노드인 XmlNode입니다. 이 노드 앞에 newChild가 있습니다.

반환 값

삽입할 노드입니다.

예외

예외 형식	조건
InvalidOperationException	현재 노드가 newChild 노드 형식의 자식 노드를 허용하지 않는 형식인 경우 newChild가 이 노드의 상위 노드일 경우
ArgumentException	이 노드를 만든 문서가 아닌 다른 문서에서 newChild를 만든 경우 refChild가 이 노드의 자식이 아닌 경우 이 노드가 읽기 전용인 경우

InvalidOperationException

현재 노드가 newChild 노드 형식의 자식 노드를 허용하지 않는 형식인 경우

newChild가 이 노드의 상위 노드일 경우

ArgumentException

이 노드를 만든 문서가 아닌 다른 문서에서 newChild를 만든 경우

refChild가 이 노드의 자식이 아닌 경우

이 노드가 읽기 전용인 경우

설명

refChild가 Null 참조(Visual Basic의 경우 Nothing)일 경우 자식 노드 목록 끝에 newChild를 삽입합니다. newChild가 XmlDocumentFragment 개체일 경우 해당하는 자식 노드가 refChild 앞에 같은 순서로 삽입됩니다. newChild가 트리에 이미 있을 경우 먼저 제거됩니다.

삽입하는 노드가 다른 문서에서 생성된 경우 XmlDocument.ImportNode를 사용하여 해당 노드를 현재 문서로 가져올 수 있습니다. 가져온 노드를 현재 문서에 삽입할 수 있습니다.

상속자 참고 사항 파생 클래스에서 InsertBefore를 재정의할 경우, 이벤트가 올바르게 발생할 수 있도록 기본 클래스의 InsertBefore 메서드를 호출해야 합니다.

예제

다음 예제에서는 XML 문서에 새 노드를 추가합니다.

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        Dim root As XmlNode = doc.DocumentElement
        
        'Create a new node.
        Dim elem As XmlElement = doc.CreateElement("price")
        elem.InnerText = "19.95"
        
        'Add the node to the document.
        root.InsertBefore(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main 
End Class 'Sample

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.InsertBefore(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   XmlNode^ root = doc->DocumentElement;
   
   //Create a new node.
   XmlElement^ elem = doc->CreateElement( "price" );
   elem->InnerText = "19.95";
   
   //Add the node to the document.
   root->InsertBefore( elem, root->FirstChild );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"
            + "<title>Pride And Prejudice</title>"
            + "</book>");

        XmlNode root = doc.get_DocumentElement();

        //Create a new node.
        XmlElement elem = doc.CreateElement("price");
        elem.set_InnerText("19.95");

        //Add the node to the document.
        root.InsertBefore(elem, root.get_FirstChild());

        Console.WriteLine("Display the modified XML...");
        doc.Save(Console.get_Out());
    } //main 
} //Sample

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

XmlNode 클래스
XmlNode 멤버
System.Xml 네임스페이스
XmlDocument.ImportNode

다음을 통해 공유