XPathNavigator.PrependChild 메서드

참조

정의

네임스페이스:: System.Xml.XPath

어셈블리:: System.Xml.ReaderWriter.dll

어셈블리:: System.Xml.XPath.dll

어셈블리:: System.Xml.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.

오버로드

PrependChild()	현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만드는 데 사용되는 XmlWriter 개체를 반환합니다.
PrependChild(String)	지정된 XML 문자열을 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.
PrependChild(XmlReader)	지정된 XmlReader 개체의 XML 콘텐츠를 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.
PrependChild(XPathNavigator)	지정된 XPathNavigator 개체에 있는 노드를 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.

PrependChild()

현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만드는 데 사용되는 XmlWriter 개체를 반환합니다.

public:
 virtual System::Xml::XmlWriter ^ PrependChild();

public virtual System.Xml.XmlWriter PrependChild ();

abstract member PrependChild : unit -> System.Xml.XmlWriter
override this.PrependChild : unit -> System.Xml.XmlWriter

Public Overridable Function PrependChild () As XmlWriter

반환

XmlWriter

현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만드는 데 사용되는 XmlWriter 개체입니다.

예외

InvalidOperationException

XPathNavigator가 있는 현재 노드 앞에 새 자식 노드를 추가할 수 없습니다.

NotSupportedException

XPathNavigator에서는 편집을 지원하지 않습니다.

예제

다음 예제에서는 메서드에서 PrependChild 반환된 개체를 사용하여 XmlWriter 파일의 첫 번째 book 요소에 대한 자식 요소 목록의 시작 부분에 새 pages 자식 요소가 contosoBooks.xml 앞에 추가됩니다.

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

XmlWriter^ pages = navigator->PrependChild();
pages->WriteElementString("pages", "100");
pages->Close();

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

XmlWriter pages = navigator.PrependChild();
pages.WriteElementString("pages", "100");
pages.Close();

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

Dim pages As XmlWriter = navigator.PrependChild()
pages.WriteElementString("pages", "100")
pages.Close()

Console.WriteLine(navigator.OuterXml)

이 예제에서는 contosoBooks.xml 파일을 입력으로 사용합니다.

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>

설명

자식 노드 앞에 추가하면 현재 노드에 대한 자식 노드 목록의 시작 부분에 새 노드가 추가됩니다. 예를 들어 요소에 대해 3개의 자식 노드가 있는 경우 앞에 추가된 노드가 첫 번째 자식 노드가 됩니다. 자식 노드가 없으면 새 자식 노드가 만들어집니다.

다음은 메서드를 사용할 PrependChild 때 고려해야 할 중요한 참고 사항입니다.

개체의 메서드가 호출될 때까지 Close 새 자식 노드가 XmlWriter 삽입되지 않습니다.
이 PrependChild 메서드는 요소 노드에 XPathNavigator 배치된 경우에만 유효합니다.
메서드는 PrependChild .의 XPathNavigator위치에 영향을 주지 않습니다.

적용 대상

PrependChild(String)

지정된 XML 문자열을 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.

public:
 virtual void PrependChild(System::String ^ newChild);

public virtual void PrependChild (string newChild);

abstract member PrependChild : string -> unit
override this.PrependChild : string -> unit

Public Overridable Sub PrependChild (newChild As String)

매개 변수

newChild: String

새 자식 노드에 대한 XML 데이터 문자열입니다.

예외

ArgumentNullException

XML 문자열 매개 변수는 null입니다.

InvalidOperationException

XPathNavigator가 있는 현재 노드 앞에 새 자식 노드를 추가할 수 없습니다.

NotSupportedException

XPathNavigator에서는 편집을 지원하지 않습니다.

XmlException

XML 문자열 매개 변수의 형식이 잘못되었습니다.

예제

다음 예제에서는 파일의 첫 번째 book 요소에 대한 자식 요소 목록의 시작 부분에 새 pages 자식 요소가 contosoBooks.xml 앞에 추가됩니다.

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

navigator->PrependChild("<pages>100</pages>");

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

navigator.PrependChild("<pages>100</pages>");

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

navigator.PrependChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

이 예제에서는 contosoBooks.xml 파일을 입력으로 사용합니다.

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>

설명

새 요소 노드를 만들려면 XML 문자열 매개 변수에 모든 XML 구문을 포함합니다. 새 book 노드의 문자열은 .입니다 PrependChild("<book/>"). 현재 노드의 텍스트 노드에 텍스트 "book"을 추가하기 위한 문자열입니다 PrependChild("book"). XML 문자열에 여러 노드가 포함된 경우 모든 노드가 추가됩니다.

다음은 메서드를 사용할 PrependChild 때 고려해야 할 중요한 참고 사항입니다.

이 PrependChild 메서드는 요소 노드에 XPathNavigator 배치된 경우에만 유효합니다.
메서드는 PrependChild .의 XPathNavigator위치에 영향을 주지 않습니다.

적용 대상

PrependChild(XmlReader)

지정된 XmlReader 개체의 XML 콘텐츠를 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);

public virtual void PrependChild (System.Xml.XmlReader newChild);

abstract member PrependChild : System.Xml.XmlReader -> unit
override this.PrependChild : System.Xml.XmlReader -> unit

Public Overridable Sub PrependChild (newChild As XmlReader)

매개 변수

newChild: XmlReader

새 자식 노드에 대한 XML 데이터에 있는 XmlReader 개체입니다.

예외

ArgumentException

XmlReader 개체가 오류 상태이거나 닫혀 있습니다.

ArgumentNullException

XmlReader 개체 매개 변수가 null입니다.

InvalidOperationException

XPathNavigator가 있는 현재 노드 앞에 새 자식 노드를 추가할 수 없습니다.

NotSupportedException

XPathNavigator에서는 편집을 지원하지 않습니다.

XmlException

XmlReader 개체 매개 변수의 XML 콘텐츠 형식이 잘못되었습니다.

예제

다음 예제에서는 지정된 개체를 사용하여 XmlReader 파일의 첫 번째 book 요소에 대한 자식 요소 목록의 시작 부분에 새 pages 자식 요소가 contosoBooks.xml 앞에 추가됩니다. http://www.contoso.com/books 새 자식 요소가 XML 문서와 동일한 네임스페이스를 사용하여 앞에 추가되도록 네임스페이스가 지정됩니다.

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

XmlReader^ pages = XmlReader::Create(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->PrependChild(pages);

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.PrependChild(pages);

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.PrependChild(pages)

Console.WriteLine(navigator.OuterXml)

이 예제에서는 contosoBooks.xml 파일을 입력으로 사용합니다.

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>

설명

다음은 메서드를 사용할 PrependChild 때 고려해야 할 중요한 참고 사항입니다.

개체가 XmlReader XML 노드 시퀀스에 배치되면 시퀀스의 모든 노드가 추가됩니다.
이 PrependChild 메서드는 요소 노드에 XPathNavigator 배치된 경우에만 유효합니다.
메서드는 PrependChild .의 XPathNavigator위치에 영향을 주지 않습니다.

적용 대상

PrependChild(XPathNavigator)

지정된 XPathNavigator 개체에 있는 노드를 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 노드를 만듭니다.

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void PrependChild (System.Xml.XPath.XPathNavigator newChild);

abstract member PrependChild : System.Xml.XPath.XPathNavigator -> unit
override this.PrependChild : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub PrependChild (newChild As XPathNavigator)

매개 변수

newChild: XPathNavigator

새 자식 노드로 추가할 노드에 있는 XPathNavigator 개체입니다.

예외

ArgumentNullException

XPathNavigator 개체 매개 변수가 null입니다.

InvalidOperationException

XPathNavigator가 있는 현재 노드 앞에 새 자식 노드를 추가할 수 없습니다.

NotSupportedException

XPathNavigator에서는 편집을 지원하지 않습니다.

예제

다음 예제에서는 지정된 개체에 포함된 XPathNavigator 노드를 사용하여 파일의 첫 번째 book 요소에 대한 자식 요소 목록의 시작 부분에 새 pages 자식 요소를 contosoBooks.xml 추가합니다. http://www.contoso.com/books XML 문서와 동일한 네임스페이스를 사용하여 새 자식 요소가 앞에 추가되도록 네임스페이스가 지정됩니다.

XmlDocument^ document = gcnew XmlDocument();
document->Load("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToChild("bookstore", "http://www.contoso.com/books");
navigator->MoveToChild("book", "http://www.contoso.com/books");

XmlDocument^ childNodes = gcnew XmlDocument();
childNodes->Load(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator^ childNodesNavigator = childNodes->CreateNavigator();

navigator->PrependChild(childNodesNavigator);

Console::WriteLine(navigator->OuterXml);

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.PrependChild(childNodesNavigator);

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")

Dim childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.PrependChild(childNodesNavigator)

Console.WriteLine(navigator.OuterXml)

이 예제에서는 contosoBooks.xml 파일을 입력으로 사용합니다.

<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>

설명

다음은 메서드를 사용할 PrependChild 때 고려해야 할 중요한 참고 사항입니다.

개체가 XPathNavigator XML 노드 시퀀스에 배치되면 시퀀스의 모든 노드가 추가됩니다.
이 PrependChild 메서드는 요소 노드에 XPathNavigator 배치된 경우에만 유효합니다.
메서드는 PrependChild .의 XPathNavigator위치에 영향을 주지 않습니다.

적용 대상

XPathNavigator.PrependChild 메서드

정의

오버로드

PrependChild()

반환

예외

예제

설명

적용 대상

PrependChild(String)

매개 변수

예외

예제

설명

적용 대상

PrependChild(XmlReader)

매개 변수

예외

예제

설명

적용 대상

PrependChild(XPathNavigator)

매개 변수

예외

예제

설명

적용 대상

추가 리소스