XPathNavigator.AppendChildElement(String, String, String, String) Methode

Definitie

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

Hiermee maakt u een nieuw onderliggend elementknooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van het voorvoegsel van de naamruimte, lokale naam en naamruimte-URI die is opgegeven met de opgegeven waarde.

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

Parameters

prefix
String

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

localName
String

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

namespaceURI
String

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

value
String

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

Uitzonderingen

InvalidOperationException

Het huidige knooppunt waarop de XPathNavigator positie is gebaseerd, is niet het hoofdknooppunt of een elementknooppunt.

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

Voorbeelden

In het volgende voorbeeld wordt een nieuw pages onderliggend element toegevoegd aan 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.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)

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 toevoegt, wordt het nieuwe knooppunt toegevoegd aan het einde van de lijst met onderliggende knooppunten voor het huidige knooppunt. Wanneer er bijvoorbeeld drie onderliggende knooppunten bestaan voor een elementknooppunt, wordt het toegevoegde knooppunt het vierde 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 methode of de LookupNamespace methode. Met de volgende syntaxis wordt bijvoorbeeld een onderliggend element toegevoegd met behulp van de naamruimte xmlns:bk=http://www.contoso.com/booksbinnen het bereik:

navigator.AppendChildElement(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 AppendChildElement 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 AppendChildElement methode is alleen geldig wanneer de XPathNavigator positie is op het hoofdknooppunt of een elementknooppunt.

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

Van toepassing op