XPathNavigator.AppendChildElement(String, String, String, String) Метод

Определение

Пространство имен:
System.Xml.XPath
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XPath.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XPathNavigator.cs
Исходный код:
XPathNavigator.cs
Исходный код:
XPathNavigator.cs
Исходный код:
XPathNavigator.cs
Исходный код:
XPathNavigator.cs

Создает новый дочерний узел элемента в конце списка дочерних узлов текущего узла с помощью префикса пространства имен, локального имени и URI пространства имен, указанного с указанным значением.

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)

Параметры

prefix
String

Префикс пространства имен нового дочернего узла элемента (если таковой есть).

localName
String

Локальное имя нового дочернего узла элемента (если таковой есть).

namespaceURI
String

Универсальный код ресурса (URI) пространства имен нового дочернего узла элемента (если таковой имеется). Empty и null эквивалентны.

value
String

Значение нового дочернего узла элемента. Если Empty или null передается, создается пустой элемент.

Исключения

InvalidOperationException

Текущий узел, на который расположен, не является корневым узлом XPathNavigator или узлом элемента.

NotSupportedException

Не поддерживает редактирование XPathNavigator .

Примеры

В следующем примере новый 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>

Комментарии

Добавление дочернего узла добавляет новый узел в конец списка дочерних узлов для текущего узла. Например, если для узла элемента существуют три дочерних узла, добавленный узел становится четвертым дочерним узлом. Если дочерние узлы отсутствуют, создается новый дочерний узел.

Префикс пространства имен и значения 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объекта.

Применяется к