Bagikan melalui


XPathNavigator.AppendChild Metode

Definisi

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini.

Overload

AppendChild()

Mengembalikan objek yang XmlWriter digunakan untuk membuat satu atau beberapa simpul anak baru di akhir daftar simpul anak dari simpul saat ini.

AppendChild(String)

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan string data XML yang ditentukan.

AppendChild(XmlReader)

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan konten XML objek XmlReader yang ditentukan.

AppendChild(XPathNavigator)

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan simpul dalam XPathNavigator yang ditentukan.

AppendChild()

Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs

Mengembalikan objek yang XmlWriter digunakan untuk membuat satu atau beberapa simpul anak baru di akhir daftar simpul anak dari simpul saat ini.

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

Mengembalikan

Objek yang XmlWriter digunakan untuk membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini.

Pengecualian

Simpul saat ini yang XPathNavigator diposisikan pada bukan simpul akar atau simpul elemen.

XPathNavigator tidak mendukung pengeditan.

Contoh

Dalam contoh berikut, elemen anak baru pages ditambahkan ke daftar elemen anak dari elemen pertama book dalam contosoBooks.xml file menggunakan objek yang XmlWriter dikembalikan dari AppendChild metode .

    XmlDocument^ document = gcnew 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);
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)

Contoh menggunakan file contosoBooks.xml sebagai input.

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

Keterangan

Menambahkan simpul anak menambahkan simpul baru ke akhir daftar simpul anak untuk simpul saat ini. Misalnya, ketika tiga simpul anak ada untuk elemen , simpul pertama yang ditambahkan menjadi simpul anak keempat. Jika tidak ada simpul anak, maka simpul anak baru akan dibuat.

Berikut ini adalah catatan penting yang perlu dipertimbangkan saat menggunakan metode .AppendChild

Anda dapat menulis lebih dari satu simpul ke penulis. Semua simpul ditambahkan ke akhir daftar simpul anak dari simpul saat ini.

Berlaku untuk

AppendChild(String)

Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan string data XML yang ditentukan.

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)

Parameter

newChild
String

String data XML untuk simpul anak baru.

Pengecualian

Parameter string data XML adalah null.

Simpul saat ini yang XPathNavigator diposisikan pada bukan simpul akar atau simpul elemen.

XPathNavigator tidak mendukung pengeditan.

Parameter string data XML tidak terbentuk dengan baik.

Contoh

Dalam contoh berikut, elemen turunan baru pages ditambahkan ke daftar elemen turunan dari elemen pertama book dalam contosoBooks.xml file.

XmlDocument^ document = gcnew 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);
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)

Contoh menggunakan file contosoBooks.xml sebagai input.

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

Keterangan

Menambahkan simpul anak menambahkan simpul baru ke akhir daftar simpul anak untuk simpul saat ini. Misalnya, ketika tiga simpul anak ada untuk elemen , simpul yang ditambahkan menjadi simpul anak keempat. Jika tidak ada simpul anak, maka simpul anak baru akan dibuat.

Untuk membuat simpul elemen baru, sertakan semua sintaks XML dalam parameter string XML. String untuk simpul baru book adalah AppendChild("<book/>"). String untuk menambahkan teks "buku" ke simpul teks simpul saat ini adalah AppendChild("book"). Jika string XML berisi beberapa simpul, semua simpul ditambahkan.

Berikut ini adalah catatan penting yang perlu dipertimbangkan saat menggunakan metode .AppendChild

Berlaku untuk

AppendChild(XmlReader)

Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan konten XML objek XmlReader yang ditentukan.

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)

Parameter

newChild
XmlReader

Objek XmlReader yang diposisikan pada data XML untuk simpul anak baru.

Pengecualian

Objek XmlReader dalam status kesalahan atau tertutup.

Parameter XmlReader objek adalah null.

Simpul saat ini yang XPathNavigator diposisikan pada bukan simpul akar atau simpul elemen.

XPathNavigator tidak mendukung pengeditan.

Konten XML parameter XmlReader objek tidak terbentuk dengan baik.

Contoh

Dalam contoh berikut, elemen anak baru pages ditambahkan ke daftar elemen anak dari elemen pertama book dalam contosoBooks.xml file menggunakan XmlReader objek yang ditentukan. Namespace http://www.contoso.com/books ditentukan sehingga elemen anak baru ditambahkan menggunakan namespace yang sama dengan dokumen XML.

XmlDocument^ document = gcnew 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(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->AppendChild(pages);

Console::WriteLine(navigator->OuterXml);
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)

Contoh menggunakan file contosoBooks.xml sebagai input.

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

Keterangan

Menambahkan simpul anak menambahkan simpul baru ke akhir daftar simpul anak untuk simpul saat ini. Misalnya, ketika tiga simpul anak ada untuk elemen , simpul yang ditambahkan menjadi simpul anak keempat. Jika tidak ada simpul anak, maka simpul anak baru akan dibuat.

Berikut ini adalah catatan penting yang perlu dipertimbangkan saat menggunakan metode .AppendChild

Berlaku untuk

AppendChild(XPathNavigator)

Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs
Sumber:
XPathNavigator.cs

Membuat simpul anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan simpul dalam XPathNavigator yang ditentukan.

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)

Parameter

newChild
XPathNavigator

Objek XPathNavigator yang diposisikan pada simpul untuk ditambahkan sebagai simpul anak baru.

Pengecualian

Parameter XPathNavigator objek adalah null.

Simpul saat ini yang XPathNavigator diposisikan pada bukan simpul akar atau simpul elemen.

XPathNavigator tidak mendukung pengeditan.

Contoh

Dalam contoh berikut, elemen anak baru pages ditambahkan ke daftar elemen anak dari elemen pertama book dalam contosoBooks.xml file menggunakan simpul yang terkandung dalam XPathNavigator yang ditentukan. Namespace http://www.contoso.com/books ditentukan sehingga elemen anak baru ditambahkan menggunakan namespace yang sama dengan dokumen XML.

XmlDocument^ document = gcnew 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 = gcnew XmlDocument();
childNodes->Load(gcnew 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);
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)

Contoh menggunakan file contosoBooks.xml sebagai input.

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

Keterangan

Menambahkan simpul anak menambahkan simpul baru ke akhir daftar simpul anak untuk simpul saat ini. Misalnya, ketika tiga simpul anak ada untuk elemen , simpul yang ditambahkan menjadi simpul anak keempat. Jika tidak ada simpul anak, maka simpul anak baru akan dibuat.

Berikut ini adalah catatan penting yang perlu dipertimbangkan saat menggunakan metode .AppendChild

Berlaku untuk