Partager via

Créer des nœuds dans le DOM

La XmlDocument classe a une méthode de création pour tous les types de nœuds. Pour créer un nœud, fournissez la méthode avec un nom, le cas échéant, et le contenu ou d’autres paramètres pour ces nœuds qui ont du contenu (par exemple, un nœud de texte). Les méthodes suivantes ont besoin d’un nom et de quelques autres paramètres remplis pour créer un nœud approprié :

D’autres types de nœuds ont plus d’exigences que de fournir des données aux paramètres.

Pour plus d’informations sur les attributs, consultez Création d’attributs pour les éléments dans le DOM. Pour plus d’informations sur la validation des noms d’élément et d’attribut, consultez XML Element and Attribute Name Verification lors de la création de nouveaux nœuds. Pour créer des références d’entité, consultez Création de références d’entité. Pour plus d’informations sur la façon dont les espaces de noms affectent l’expansion des références d’entité, consultez L’impact de l’espace de noms sur l’expansion de référence d’entité pour les nouveaux nœuds contenant des éléments et des attributs.

Une fois les nouveaux nœuds créés, plusieurs méthodes sont disponibles pour les insérer dans l’arborescence. Le tableau répertorie les méthodes avec une description de l’emplacement où le nouveau nœud apparaît dans le modèle DOM (Document Object Model) XML.

Méthode Positionnement des nœuds
InsertBefore Inséré avant le nœud de référence. Par exemple, pour insérer le nouveau nœud à la position 5 :

XmlNode refChild = node.ChildNodes[4]; // The reference is zero-based.

node.InsertBefore(newChild, refChild);

Pour plus d’informations, consultez la InsertBefore méthode.
InsertAfter Inséré après le nœud de référence. Par exemple:

node.InsertAfter(newChild, refChild);

Pour plus d’informations, consultez la InsertAfter méthode.
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 XmlDocumentFragment, tout le contenu du fragment de document est déplacé dans la liste enfant de ce nœud. Pour plus d’informations, consultez la AppendChild méthode.
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 XmlDocumentFragment, tout le contenu du fragment de document est déplacé dans la liste enfant de ce nœud. Pour plus d’informations, consultez la PrependChild méthode.
Append Ajoute un XmlAttribute nœud à la fin de la collection d’attributs associée à un élément. Pour plus d’informations, consultez la Append méthode.

Voir aussi