XmlDocument.InsertBefore(IXmlNode, IXmlNode) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Insère un nœud enfant à gauche du nœud spécifié ou à la fin de la liste des nœuds enfants.
public:
virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);function insertBefore(newChild, referenceChild)Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNodeParamètres
- newChild
- IXmlNode
Adresse du nouveau nœud à insérer. Le nœud passé ici doit être un enfant valide du nœud de document DOM XML actuel. Par exemple, si le nœud actuel est un attribut, vous ne pouvez pas passer un autre attribut dans le paramètre newChild , car un attribut ne peut pas avoir un attribut comme enfant. Si newChild est un type de nœud DOCUMENT_FRAGMENT, tous ses enfants sont insérés dans l’ordre avant referenceChild.
Si newChild est déjà dans l’arborescence, il est d’abord supprimé avant d’être réinséré avant le nœud referenceChild . Les nœuds en lecture seule, tels que les nœuds NODE_DOCUMENT_TYPE et NODE_ENTITY, ne peuvent pas être passés dans le paramètre newChild .
- referenceChild
- IXmlNode
Le nœud de référence. Le nœud spécifié est l’emplacement où le nœud newChild doit être inséré à gauche en tant que frère précédent dans la liste enfant. Le nœud passé ici doit être un nœud enfant du nœud actuel ou null. Si la valeur est null, le nœud newChild est inséré à la fin de la liste enfant. Si le nœud referenceChild n’est pas un enfant du nœud actuel, une erreur est retournée.
Retours
En cas de réussite, nœud enfant qui a été inséré. Si la valeur est null, aucun objet n’est créé.