XPathNavigator.AppendChild Metódus

Definíció

Névtér:: System.Xml.XPath

Szerelvények:: netstandard.dll, System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.XPath.dll

Szerelvény:: System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén.

Túlterhelések

Name	Description
AppendChild()	XmlWriter Az aktuális csomópont gyermekcsomópontjainak listájának végén egy vagy több új gyermekcsomópont létrehozásához használt objektumot ad vissza.
AppendChild(String)	Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott XML-adatsztring használatával.
AppendChild(XmlReader)	Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott objektum XML-tartalmának XmlReader használatával.
AppendChild(XPathNavigator)	Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott csomópontok XPathNavigator használatával.

AppendChild()

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

XmlWriter Az aktuális csomópont gyermekcsomópontjainak listájának végén egy vagy több új gyermekcsomópont létrehozásához használt objektumot ad vissza.

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

Válaszok

XmlWriter

Új XmlWriter gyermekcsomópontok létrehozásához használt objektum az aktuális csomópont gyermekcsomópontjainak listájának végén.

Kivételek

InvalidOperationException

Az aktuális csomópont XPathNavigator , amelyen elhelyezve van, nem a gyökércsomópont vagy elemcsomópont.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában egy új pages gyermekelem lesz hozzáfűzve a fájl első book elemének gyermekelemeinek listájához a contosoBooks.xmlXmlWriter metódus által AppendChild visszaadott objektummal.

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

A gyermekcsomópontok hozzáfűzése hozzáadja az új csomópontokat az aktuális csomóponthoz tartozó gyermekcsomópontok listájának végére. Ha például három gyermekcsomópont létezik egy elemhez, az első hozzáfűzött csomópont lesz a negyedik gyermekcsomópont. Ha nincsenek gyermekcsomópontok, akkor létrejön egy új gyermekcsomópont.

A módszer használatakor AppendChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Az új gyermekcsomópont csak az Close objektum metódusának meghívása XmlWriter után lesz beszúrva.
A AppendChild metódus csak akkor érvényes, ha a XPathNavigator gyökércsomóponton vagy egy elemcsomóponton van elhelyezve.
A AppendChild metódus nem befolyásolja a XPathNavigator.

Több csomópontot is írhat az írónak. Minden csomópont hozzá lesz fűzve az aktuális csomópont gyermekcsomópontjainak listájának végéhez.

A következőre érvényes:

AppendChild(String)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott XML-adatsztring használatával.

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)

Paraméterek

newChild: String

Az új gyermekcsomópont XML-adatsztringje.

Kivételek

ArgumentNullException

Az XML-adatsztring paramétere.null

InvalidOperationException

Az aktuális csomópont XPathNavigator , amelyen elhelyezve van, nem a gyökércsomópont vagy elemcsomópont.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

XmlException

Az XML-adatsztring paraméter nem megfelelően formázott.

Példák

Az alábbi példában egy új pages gyermekelem lesz hozzáfűzve a fájl első book elemének gyermekelemeinek listájához contosoBooks.xml .

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

A gyermekcsomópont hozzáfűzése hozzáadja az új csomópontot az aktuális csomóponthoz tartozó gyermekcsomópontok listájának végéhez. Ha például három gyermekcsomópont létezik egy elemhez, a hozzáfűzött csomópont lesz a negyedik gyermekcsomópont. Ha nincsenek gyermekcsomópontok, akkor létrejön egy új gyermekcsomópont.

Új elemcsomópont létrehozásához adja meg az XML-sztring paraméter összes XML-szintaxisát. Az új book csomópont sztringje a következő AppendChild("<book/>"): . A "book" szövegnek az aktuális csomópont szövegcsomóponthoz való hozzáfűzésére szolgáló sztring az AppendChild("book"). Ha az XML-sztring több csomópontot tartalmaz, az összes csomópont hozzá lesz adva.

A módszer használatakor AppendChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

A AppendChild metódus csak akkor érvényes, ha a XPathNavigator gyökércsomóponton vagy egy elemcsomóponton van elhelyezve.
A AppendChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

AppendChild(XmlReader)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott objektum XML-tartalmának XmlReader használatával.

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)

Paraméterek

newChild: XmlReader

Az XmlReader új gyermekcsomópont XML-adatain elhelyezett objektum.

Kivételek

ArgumentException

Az XmlReader objektum hibaállapotban vagy bezárt állapotban van.

ArgumentNullException

Az XmlReader objektumparaméter a következő null: .

InvalidOperationException

Az aktuális csomópont XPathNavigator , amelyen elhelyezve van, nem a gyökércsomópont vagy elemcsomópont.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

XmlException

Az objektumparaméter XML-tartalma XmlReader nem megfelelően formázott.

Példák

Az alábbi példában egy új pages gyermekelem lesz hozzáfűzve a fájl első book elemének gyermekelemeinek listájához a contosoBooks.xmlXmlReader megadott objektummal. A http://www.contoso.com/books névtér úgy van megadva, hogy az új gyermekelem ugyanazzal a névtérrel legyen hozzáfűzve, mint az XML-dokumentum.

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

A módszer használatakor AppendChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Ha az XmlReader objektum XML-csomópontok sorozata fölé van helyezve, a rendszer hozzáadja a sorozat összes csomópontját.
A AppendChild metódus csak akkor érvényes, ha a XPathNavigator gyökércsomóponton vagy egy elemcsomóponton van elhelyezve.
A AppendChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

AppendChild(XPathNavigator)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott csomópontok XPathNavigator használatával.

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)

Paraméterek

newChild: XPathNavigator

Új XPathNavigator gyermekcsomópontként hozzáadni kívánt objektum a csomóponton.

Kivételek

ArgumentNullException

Az XPathNavigator objektumparaméter a következő null: .

InvalidOperationException

Az aktuális csomópont XPathNavigator , amelyen elhelyezve van, nem a gyökércsomópont vagy elemcsomópont.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

A következő példában egy új pages gyermekelem lesz hozzáfűzve a fájl első book elemének gyermekelemeinek listájához a contosoBooks.xml megadott csomópont XPathNavigator használatával. A http://www.contoso.com/books névtér úgy van megadva, hogy az új gyermekelem ugyanazzal a névtérrel legyen hozzáfűzve, mint az XML-dokumentum.

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

A módszer használatakor AppendChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Ha az XPathNavigator objektum XML-csomópontok sorozata fölé van helyezve, a rendszer hozzáadja a sorozat összes csomópontját.
A AppendChild metódus csak akkor érvényes, ha a XPathNavigator gyökércsomóponton vagy egy elemcsomóponton van elhelyezve.
A AppendChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?