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

public:
 virtual void AppendChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void AppendChildElement(string? prefix, string localName, string? namespaceURI, string? value);

public virtual void AppendChildElement(string prefix, string localName, string namespaceURI, string value);

abstract member AppendChildElement : string * string * string * string -> unit
override this.AppendChildElement : string * string * string * string -> unit

Public Overridable Sub AppendChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

매개 변수

예외

예제

다음 예제에서는 pages 파일 내에서 첫 번째 book 요소의 자식 요소 목록에 새 contosoBooks.xml 자식 요소가 추가됩니다.

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.AppendChildElement(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.AppendChildElement(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 값은 메서드 또는 LookupPrefix 메서드를 LookupNamespace 사용하여 가져올 수 있습니다. 예를 들어 다음 구문은 범위 내 네임스페 xmlns:bk=http://www.contoso.com/books이스를 사용하여 자식 요소를 추가합니다.

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

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

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

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

• 이 AppendChildElement 메서드는 루트 노드 또는 요소 노드에 배치된 경우에만 XPathNavigator 유효합니다.

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