XPathNavigator.AppendChild Methode

Definitie

Naamruimte:: System.Xml.XPath

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt.

Overloads

Name	Description
AppendChild()	Retourneert een XmlWriter object dat wordt gebruikt voor het maken van een of meer nieuwe onderliggende knooppunten aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt.
AppendChild(String)	Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de opgegeven XML-gegevensreeks.
AppendChild(XmlReader)	Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de XML-inhoud van het XmlReader opgegeven object.
AppendChild(XPathNavigator)	Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de knooppunten in de XPathNavigator opgegeven.

AppendChild()

Retourneert een XmlWriter object dat wordt gebruikt voor het maken van een of meer nieuwe onderliggende knooppunten aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt.

public:
 virtual System::Xml::XmlWriter ^ AppendChild();

public virtual System.Xml.XmlWriter AppendChild();

abstract member AppendChild : unit -> System.Xml.XmlWriter
override this.AppendChild : unit -> System.Xml.XmlWriter

Public Overridable Function AppendChild () As XmlWriter

Retouren

XmlWriter

Een XmlWriter object dat wordt gebruikt voor het maken van nieuwe onderliggende knooppunten aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt.

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

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

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

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

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 onderliggende knooppunten toevoegt, worden de nieuwe knooppunten toegevoegd aan het einde van de lijst met onderliggende knooppunten voor het huidige knooppunt. Wanneer er bijvoorbeeld drie onderliggende knooppunten bestaan voor een element, wordt het eerste toegevoegde knooppunt het vierde onderliggende knooppunt. Als er geen onderliggende knooppunten bestaan, wordt er een nieuw onderliggend knooppunt gemaakt.

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

Het nieuwe onderliggende knooppunt wordt pas ingevoegd als de Close methode van het XmlWriter object wordt aangeroepen.
De AppendChild methode is alleen geldig wanneer de XPathNavigator positie is op het hoofdknooppunt of een elementknooppunt.
De AppendChild methode heeft geen invloed op de positie van de XPathNavigator.

U kunt meer dan één knooppunt naar de schrijver schrijven. Alle knooppunten worden toegevoegd aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt.

Van toepassing op

AppendChild(String)

Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de opgegeven XML-gegevensreeks.

public:
 virtual void AppendChild(System::String ^ newChild);

public virtual void AppendChild(string newChild);

abstract member AppendChild : string -> unit
override this.AppendChild : string -> unit

Public Overridable Sub AppendChild (newChild As String)

Parameters

newChild: String

De XML-gegevensreeks voor het nieuwe onderliggende knooppunt.

Uitzonderingen

ArgumentNullException

De parameter XML-gegevensreeks is null.

InvalidOperationException

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

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

XmlException

De xml-gegevensreeksparameter is niet goed opgemaakt.

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.AppendChild("<pages>100</pages>");

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.AppendChild("<pages>100</pages>")

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 voor een element bestaan, wordt het toegevoegde knooppunt het vierde onderliggende knooppunt. Als er geen onderliggende knooppunten bestaan, wordt er een nieuw onderliggend knooppunt gemaakt.

Als u een nieuw elementknooppunt wilt maken, moet u alle XML-syntaxis opnemen in de xml-tekenreeksparameter. De tekenreeks voor een nieuw book knooppunt is AppendChild("<book/>"). De tekenreeks voor het toevoegen van het tekstboek aan het tekstknooppunt van het huidige knooppunt is AppendChild("book"). Als de XML-tekenreeks meerdere knooppunten bevat, worden alle knooppunten toegevoegd.

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

De AppendChild methode is alleen geldig wanneer de XPathNavigator positie is op het hoofdknooppunt of een elementknooppunt.
De AppendChild methode heeft geen invloed op de positie van de XPathNavigator.

Van toepassing op

AppendChild(XmlReader)

Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de XML-inhoud van het XmlReader opgegeven object.

public:
 virtual void AppendChild(System::Xml::XmlReader ^ newChild);

public virtual void AppendChild(System.Xml.XmlReader newChild);

abstract member AppendChild : System.Xml.XmlReader -> unit
override this.AppendChild : System.Xml.XmlReader -> unit

Public Overridable Sub AppendChild (newChild As XmlReader)

Parameters

newChild: XmlReader

Een XmlReader object dat is geplaatst op de XML-gegevens voor het nieuwe onderliggende knooppunt.

Uitzonderingen

ArgumentException

Het XmlReader object heeft een foutstatus of is gesloten.

ArgumentNullException

De XmlReader objectparameter is null.

InvalidOperationException

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

NotSupportedException

De XPathNavigator bewerking wordt niet ondersteund.

XmlException

De XML-inhoud van de XmlReader objectparameter is niet goed opgemaakt.

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 met behulp van het XmlReader opgegeven object. De http://www.contoso.com/books naamruimte wordt opgegeven zodat het nieuwe onderliggende element wordt toegevoegd met dezelfde naamruimte als het XML-document.

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

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.AppendChild(pages);

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

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.AppendChild(pages)

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

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

Als het XmlReader object is geplaatst op een reeks XML-knooppunten, worden alle knooppunten in de reeks toegevoegd.
De AppendChild methode is alleen geldig wanneer de XPathNavigator positie is op het hoofdknooppunt of een elementknooppunt.
De AppendChild methode heeft geen invloed op de positie van de XPathNavigator.

Van toepassing op

AppendChild(XPathNavigator)

Hiermee maakt u een nieuw onderliggend knooppunt aan het einde van de lijst met onderliggende knooppunten van het huidige knooppunt met behulp van de knooppunten in de XPathNavigator opgegeven.

public:
 virtual void AppendChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void AppendChild(System.Xml.XPath.XPathNavigator newChild);

abstract member AppendChild : System.Xml.XPath.XPathNavigator -> unit
override this.AppendChild : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub AppendChild (newChild As XPathNavigator)

Parameters

newChild: XPathNavigator

Een XPathNavigator object dat op het knooppunt wordt geplaatst om toe te voegen als het nieuwe onderliggende knooppunt.

Uitzonderingen

ArgumentNullException

De XPathNavigator objectparameter is null.

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 met behulp van het knooppunt in de XPathNavigator opgegeven. De http://www.contoso.com/books naamruimte wordt opgegeven zodat het nieuwe onderliggende element wordt toegevoegd met dezelfde naamruimte als het XML-document.

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

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

if(childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books"))
{
    navigator.AppendChild(childNodesNavigator);
}

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

Dim childNodes As XmlDocument = New XmlDocument()

childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

If childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books") Then
    navigator.AppendChild(childNodesNavigator)
End If

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

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

Als het XPathNavigator object is geplaatst op een reeks XML-knooppunten, worden alle knooppunten in de reeks toegevoegd.
De AppendChild methode is alleen geldig wanneer de XPathNavigator positie is op het hoofdknooppunt of een elementknooppunt.
De AppendChild methode heeft geen invloed op de positie van de XPathNavigator.

Van toepassing op

Feedback

Is deze pagina nuttig?