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

Définition

Espace de noms:
System.Xml.XPath
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XPath.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Crée un élément enfant au début de la liste des nœuds enfants du nœud actuel à l’aide du préfixe d’espace de noms, du nom local et de l’URI d’espace de noms spécifiés avec la valeur spécifiée.

public:
 virtual void PrependChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual void PrependChildElement(string? prefix, string localName, string? namespaceURI, string? value);
public virtual void PrependChildElement(string prefix, string localName, string namespaceURI, string value);
abstract member PrependChildElement : string * string * string * string -> unit
override this.PrependChildElement : string * string * string * string -> unit
Public Overridable Sub PrependChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Paramètres

prefix
String

Préfixe d’espace de noms du nouvel élément enfant (le cas échéant).

localName
String

Nom local du nouvel élément enfant (le cas échéant).

namespaceURI
String

URI d’espace de noms du nouvel élément enfant (le cas échéant). Empty et null sont équivalents.

value
String

Valeur du nouvel élément enfant. S’il Empty est passé ou null passé, un élément vide est créé.

Exceptions

InvalidOperationException

Le nœud actuel sur lequel il XPathNavigator est positionné n’autorise pas l’ajout d’un nouveau nœud enfant.

NotSupportedException

La XPathNavigator modification ne prend pas en charge la modification.

Exemples

Dans l’exemple suivant, un nouvel pages élément enfant est ajouté au début de 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.PrependChildElement(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.PrependChildElement(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 préalable d’un nœud enfant au début de la liste des nœuds enfants pour le nœud actuel est ajouté au nouveau nœud. Par exemple, quand trois nœuds enfants existent pour un élément, le nœud prépendé devient le premier 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 ou LookupPrefix de la LookupNamespace méthode. Par exemple, la syntaxe suivante précède un élément enfant à l’aide de l’espace de noms xmlns:bk="http://www.contoso.com/books"dans l’étendue :

navigator.PrependChildElement(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 PrependChildElement 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 PrependChildElement méthode est valide uniquement lorsque l’élément XPathNavigator est positionné sur un nœud d’élément.

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

S’applique à