다음을 통해 공유


XPathNavigator.PrependChildElement(String, String, String, String) 메서드

정의

지정된 값과 함께 네임스페이스 접두사, 로컬 이름 및 네임스페이스 URI를 사용하여 현재 노드의 자식 노드 목록 맨 앞에 새 자식 요소 노드를 만듭니다.

public:
 virtual void PrependChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual void PrependChildElement (string prefix, string localName, string namespaceURI, string value);
public virtual void PrependChildElement (string? prefix, string localName, string? namespaceURI, string? value);
abstract member PrependChildElement : string * string * string * string -> unit
override this.PrependChildElement : string * string * string * string -> unit
Public Overridable Sub PrependChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

매개 변수

prefix
String

새 자식 요소의 네임스페이스 접두사입니다(있는 경우).

localName
String

새 자식 요소의 로컬 이름입니다(있는 경우).

namespaceURI
String

새 자식 요소의 네임스페이스 URI입니다(있는 경우). Emptynull는 동일합니다.

value
String

새 자식 요소의 값입니다. Empty 또는 null을 전달하면 빈 요소가 생성됩니다.

예외

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

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

예제

다음 예제에서는 파일의 첫 번째 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->PrependChildElement(navigator->Prefix, "pages", navigator->LookupNamespace(navigator->Prefix), "100");

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.PrependChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

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.PrependChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100")

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개의 자식 노드가 있는 경우 앞에 추가된 노드는 첫 번째 자식 노드가 됩니다. 자식 노드가 없으면 새 자식 노드가 만들어집니다.

네임스페이스 접두사 및 URI 값은 또는 LookupNamespace 메서드를 LookupPrefix 사용하여 가져올 수 있습니다. 예를 들어 다음 구문은 scope 내 네임스페xmlns:bk="http://www.contoso.com/books"이스를 사용하여 자식 요소 앞에 추가합니다.

navigator.PrependChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)  

그러면 새 자식 <bk:pages/> 요소가 만들어집니다.

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

  • 지정된 네임스페이스 접두사 가 null 또는 String.Empty이면 새 요소의 네임스페이스 URI에 대한 접두사는 현재 scope 네임스페이스에서 가져옵니다. 현재 scope 지정된 네임스페이스 URI에 할당된 네임스페이스 접두사가 없는 경우 네임스페이스 접두사는 자동으로 생성됩니다.

  • 메서드는 PrependChildElement 가 요소 노드에 있는 경우에만 XPathNavigator 유효합니다.

  • 메서드는 PrependChildElementXPathNavigator위치에 영향을 주지 않습니다.

적용 대상