XPathNavigator.AppendChildElement(String, String, String, String) Méthode

public:
 virtual void AppendChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void AppendChildElement(string? prefix, string localName, string? namespaceURI, string? value);

public virtual void AppendChildElement(string prefix, string localName, string namespaceURI, string value);

abstract member AppendChildElement : string * string * string * string -> unit
override this.AppendChildElement : string * string * string * string -> unit

Public Overridable Sub AppendChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Paramètres

Exceptions

Exemples

Dans l’exemple suivant, un nouvel pages élément enfant est ajouté à la liste des éléments enfants du premier book élément du contosoBooks.xml fichier.

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");

navigator.AppendChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

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

navigator.AppendChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100")

Console.WriteLine(navigator.OuterXml)

L’exemple prend le contosoBooks.xml fichier en tant qu’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>

Remarques

L’ajout d’un nœud enfant ajoute le nouveau nœud à la fin de la liste des nœuds enfants pour le nœud actuel. Par exemple, quand trois nœuds enfants existent pour un nœud d’élément, le nœud ajouté devient le quatrième nœud enfant. Si aucun nœud enfant n’existe, un nouveau nœud enfant est créé.

Le préfixe d’espace de noms et les valeurs d’URI peuvent être obtenus à l’aide de la LookupPrefix méthode ou de la LookupNamespace méthode. Par exemple, la syntaxe suivante ajoute un élément enfant à l’aide de l’espace de noms xmlns:bk=http://www.contoso.com/booksdans l’étendue :

navigator.AppendChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)

Cela crée le nouvel élément enfant <bk:pages/> .

Les remarques suivantes sont importantes à prendre en compte lors de l’utilisation de la AppendChildElement méthode.

• Si le préfixe d’espace de noms spécifié est null ou String.Empty, le préfixe de l’URI d’espace de noms du nouvel élément est obtenu à partir des espaces de noms actuels dans l’étendue. S’il n’existe aucun préfixe d’espace de noms affecté à l’URI d’espace de noms spécifié dans l’étendue actuelle, un préfixe d’espace de noms est généré automatiquement.

• La AppendChildElement méthode est valide uniquement lorsque le XPathNavigator nœud racine ou un nœud d’élément est positionné.

• La AppendChildElement méthode n’affecte pas la position du XPathNavigator.