Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

XPathNavigator.AppendChild, méthode

Retourne un objet XmlWriter permettant de créer un ou plusieurs nœuds enfants à la fin de la liste de nœuds enfants du nœud actuel.

Espace de noms :  System.Xml.XPath
Assembly :  System.Xml (dans System.Xml.dll)

public virtual XmlWriter AppendChild()

Valeur de retour

Type : System.Xml.XmlWriter
Un objet XmlWriter permettant de créer des nœuds enfants à la fin de la liste de nœuds enfants du nœud actuel.

ExceptionCondition
InvalidOperationException

Le nœud actuel sur lequel XPathNavigator est positionné ne correspond pas au nœud racine ou à un nœud d'élément.

NotSupportedException

XPathNavigator ne prend pas en charge l'édition.

Des nœuds enfants sont ajoutés à la fin de la liste des nœuds enfants du nœud actuel. Par exemple, quand trois nœuds enfants existent pour un élément, le premier nœud ajouté devient le quatrième nœud enfant. Si aucun nœud enfant n'existe, un nœud est créé.

Vous trouverez ci-dessous d'importantes remarques à prendre en considération lors de l'utilisation de la méthode AppendChild.

Vous pouvez écrire plusieurs nœuds au writer. Tous les nœuds sont ajoutés à la fin de la liste de nœuds enfants du nœud actuel.

Dans l'exemple suivant, un nouvel élément enfant pages est ajouté à la liste d'éléments enfants du premier élément book dans le fichier contosoBooks.xml à l'aide de l'objet XmlWriter retourné par la méthode AppendChild.


XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");

XmlWriter pages = navigator.AppendChild();
pages.WriteElementString("pages", "100");
pages.Close();

Console.WriteLine(navigator.OuterXml);


L'exemple prend le fichier contosoBooks.xml comme entrée.


<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher: