Создание новых узлов в модели DOMCreate New Nodes in the DOM

К классе XmlDocument доступен метод для создания всех типов узлов.The XmlDocument has a create method for all of the node types. Для создания узла методу нужно передать имя (если необходимо) и содержимое или другие параметры для узлов, имеющих содержимое (например, текстовый узел).Supply the method with a name when required, and content or other parameters for those nodes that have content (for example, a text node), and the node is created. Далее представлены методы, которым необходимо передать имя и некоторые другие параметры для создания нужного узла.The following methods are ones that need a name and a few other parameters filled to create an appropriate node.

Для других типов узлов недостаточно просто задать данные параметров.Other node types have more requirements than just providing data to parameters.

См. дополнительные сведения по созданию атрибутов для элементов в модели DOM.For information on attributes, see Creating New Attributes for Elements in the DOM. См. дополнительные сведения о проверке имен атрибутов и элементов XML при создании узлов.For information on element and attribute name validation, see XML Element and Attribute Name Verification when Creating New Nodes. См. дополнительные сведения о создании ссылок на сущности.For creating entity references, see Creating New Entity References. См. дополнительные сведения о влиянии пространства имен на раскрытие ссылок на сущности для новых узлов, содержащих элементы и атрибуты.For information on how namespaces affect the expansion of entity references, see Namespace Affect on Entity Reference Expansion for New Nodes Containing Elements and Attributes.

После создания новых узлов становятся доступны несколько методов для вставки узлов в дерево.Once new nodes are created, there are several methods available to insert them into the tree. В таблице перечислены методы и описано место появления нового узла в модели XML DOM.The table lists the methods with a description of where the new node appears in the XML Document Object Model (DOM).

МетодMethod Размещение узлаNode placement
InsertBefore Вставляется перед узлом ссылки.Inserted before the reference node. Например, следующий код вставляет новый узел в позицию 5:For example, to insert the new node in position 5:

Dim refChild As XmlNode = node.ChildNodes(4) 'The reference is zero-based.node.InsertBefore(newChild, refChild);

XmlNode refChild = node.ChildNodes[4]; //The reference is zero-based. node.InsertBefore(newChild, refChild);

Дополнительные сведения см. в описании метода InsertBefore.For more information, see the InsertBefore method.
InsertAfter Вставляется после узла ссылки.Inserted after the reference node. Например:For example:

node.InsertAfter(newChild, refChild)

node.InsertAfter(newChild, refChild);

Дополнительные сведения см. в описании метода InsertAfter.For more information, see the InsertAfter method.
AppendChild Добавляет узел в конец списка дочерних узлов заданного узла.Adds the node to the end of the list of child nodes for the given node. Если добавляемый узел представляет собой XmlDocumentFragment, все содержимое фрагмента документа перемещается в дочерний список этого узла.If the node being added is an XmlDocumentFragment, the entire contents of the document fragment are moved into the child list of this node. Дополнительные сведения см. в описании метода AppendChild.For more information, see the AppendChild method.
PrependChild Добавляет узел в начало списка дочерних узлов заданного узла.Adds the node to the beginning of the list of child nodes of the given node. Если добавляемый узел представляет собой XmlDocumentFragment, все содержимое фрагмента документа перемещается в дочерний список этого узла.If the node being added is an XmlDocumentFragment, the entire contents of the document fragment are moved into the child list of this node. Дополнительные сведения см. в описании метода PrependChild.For more information, see the PrependChild method.
Append Добавляет узел XmlAttribute в конец коллекции атрибутов, связанной с элементом.Appends an XmlAttribute node to the end of the attribute collection associated with an element. Дополнительные сведения см. в описании метода Append.For more information, see the Append method.

См. также:See also