XPathNavigator.PrependChildElement(String, String, String, String) Methode

Definitie

Naamruimte:
System.Xml.XPath
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Maakt een nieuw onderliggend element aan het begin van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van het voorvoegsel van de naamruimte, de lokale naam en de naamruimte-URI die is opgegeven met de opgegeven waarde.

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

Parameters

prefix
String

Het voorvoegsel van de naamruimte van het nieuwe onderliggende element (indien van toepassing).

localName
String

De lokale naam van het nieuwe onderliggende element (indien van toepassing).

namespaceURI
String

De naamruimte-URI van het nieuwe onderliggende element (indien van toepassing). Empty en null gelijkwaardig zijn.

value
String

De waarde van het nieuwe onderliggende element. Als Empty of null worden doorgegeven, wordt er een leeg element gemaakt.

Uitzonderingen

InvalidOperationException

Het huidige knooppunt waarop de XPathNavigator positie zich bevindt, staat niet toe dat een nieuw onderliggend knooppunt wordt voorbereid.

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

Voorbeelden

In het volgende voorbeeld wordt een nieuw pages onderliggend element voorafgegaan aan het begin van de lijst met onderliggende elementen van het eerste book element in het contosoBooks.xml bestand.

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)

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

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

Opmerkingen

Als u een onderliggend knooppunt voorbereidt, wordt het nieuwe knooppunt toegevoegd aan het begin van de lijst met onderliggende knooppunten voor het huidige knooppunt. Wanneer er bijvoorbeeld drie onderliggende knooppunten voor een element bestaan, wordt het voorgeprependeerde knooppunt het eerste onderliggende knooppunt. Als er geen onderliggende knooppunten bestaan, wordt er een nieuw onderliggend knooppunt gemaakt.

Naamruimtevoorvoegsel en URI-waarden kunnen worden verkregen met behulp van de LookupPrefix of LookupNamespace methode. Met de volgende syntaxis wordt bijvoorbeeld een onderliggend element voorafgegaan door gebruik te maken van de naamruimte xmlns:bk="http://www.contoso.com/books"binnen het bereik:

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

Hiermee maakt u het nieuwe onderliggende <bk:pages/> element.

Hier volgen belangrijke opmerkingen bij het gebruik van de PrependChildElement methode.

  • Als het opgegeven voorvoegsel voor de naamruimte is null of String.Empty, wordt het voorvoegsel voor de naamruimte-URI van het nieuwe element verkregen van de huidige naamruimten binnen het bereik. Als er op het huidige bereik geen naamruimtevoorvoegsel is toegewezen aan de opgegeven naamruimte-URI, wordt automatisch een naamruimtevoorvoegsel gegenereerd.

  • De PrependChildElement methode is alleen geldig wanneer de XPathNavigator positie is op een elementknooppunt.

  • De PrependChildElement methode heeft geen invloed op de positie van de XPathNavigator.

Van toepassing op