Création de nouveaux nœuds dans le DOM
La classe XmlDocument a une méthode create pour tous les types de nœud. Pour créer un nœud, donnez un nom à la méthode, le cas échéant, et fournissez du contenu ou d’autres paramètres pour les nœuds ayant du contenu (par exemple un nœud de texte). Les méthodes suivantes nécessitent un nom et d’autres paramètres pour permettre la création d’un nœud approprié :
La création des autres types de nœuds exige d’autres opérations : il ne suffit pas de fournir des données à des paramètres.
Pour plus d'informations sur les attributs, consultez Création de nouveaux attributs pour des éléments du DOM. Pour plus d’informations sur la validation des noms d’élément et d’attribut, consultez Vérification des noms d’attribut et d’élément XML lors de la création de nœuds. Pour plus d'informations sur la création de références d'entité, consultez Création de nouvelles références d'entité. Pour plus d'informations sur la manière dont les espaces de noms influent sur le développement des références d'entité, consultez Effet des espaces de noms sur le développement des références d'entité avec les nouveaux nœuds contenant des éléments et attributs.
Une fois de nouveaux nœuds créés, plusieurs méthodes sont disponibles pour insérer ces nœuds dans l'arborescence. Ce tableau répertorie ces méthodes et décrit la position qu'occupe le nouveau nœud dans le DOM (Document Object Model) XML.
| Méthode | Emplacement du nœud |
|---|---|
| InsertBefore | Inséré avant le nœud de référence. Par exemple, pour insérer le nouveau nœud en position 5 :XmlNode refChild = node.ChildNodes[4]; // The reference is zero-based.node.InsertBefore(newChild, refChild);Pour plus d'informations, voir la méthode InsertBefore. |
| InsertAfter | Inséré après le nœud de référence. Par exemple :node.InsertAfter(newChild, refChild);Pour plus d'informations, voir la méthode InsertAfter. |
| AppendChild | Ajoute le nœud à la fin de la liste des nœuds enfants du nœud donné. Si le nœud ajouté est un objet XmlDocumentFragment, l'ensemble du contenu du fragment de document est déplacé dans la liste des enfants de ce nœud. Pour plus d'informations, voir la méthode AppendChild. |
| PrependChild | Ajoute le nœud au début de la liste des nœuds enfants du nœud donné. Si le nœud ajouté est un objet XmlDocumentFragment, l'ensemble du contenu du fragment de document est déplacé dans la liste des enfants de ce nœud. Pour plus d'informations, voir la méthode PrependChild. |
| Append | Ajoute un nœud XmlAttribute à la fin de la collection d’attributs associée à un élément. Pour plus d'informations, voir la méthode Append. |
