XmlEntityReference.InsertBefore(IXmlNode, IXmlNode) Méthode

Définition

Espace de noms:

Windows.Data.Xml.Dom

Insère un nœud enfant à gauche du nœud spécifié ou à la fin de la liste.

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 IXmlNode

Paramètres

newChild

IXmlNode

Adresse du nouveau nœud à insérer. Le nœud transmis 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 d’attribut en tant qu’enfant. Si newChild est un type de nœud DOCUMENT_FRAGMENT, tous ses enfants sont insérés dans l’ordre avant référenceChild.

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 transmis 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

IXmlNode

En cas de réussite, nœud enfant qui a été inséré. Si la valeur est null, aucun objet n’est créé.

Implémente

InsertBefore(IXmlNode, IXmlNode)