XPathNavigator.AppendChildElement(String, String, String, String) Metode

Definisi

Ruang nama:

System.Xml.XPath

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XPathNavigator.cs

Membuat simpul elemen anak baru di akhir daftar simpul anak dari simpul saat ini menggunakan awalan namespace, nama lokal, dan URI namespace layanan yang ditentukan dengan nilai yang ditentukan.

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)

Parameter

prefix

String

Awalan namespace dari simpul elemen anak baru (jika ada).

localName

String

Nama lokal simpul elemen anak baru (jika ada).

namespaceURI

String

URI namespace layanan dari simpul elemen anak baru (jika ada). Empty dan null setara.

value

String

Nilai simpul elemen anak baru. Jika Empty atau null diteruskan, elemen kosong akan dibuat.

Pengecualian

InvalidOperationException

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

NotSupportedException

XPathNavigator tidak mendukung pengeditan.

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->AppendChildElement(navigator->Prefix, "pages", navigator->LookupNamespace(navigator->Prefix), "100");

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

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 ada tiga simpul anak untuk simpul elemen, simpul yang ditambahkan menjadi simpul anak keempat. Jika tidak ada simpul anak, maka simpul anak baru akan dibuat.

Nilai awalan namespace dan URI dapat diperoleh dengan menggunakan LookupPrefix metode atau LookupNamespace metode . Misalnya, sintaks berikut menambahkan elemen anak dengan menggunakan namespace xmlns:bk=http://www.contoso.com/booksdalam cakupan :

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

Ini membuat elemen anak <bk:pages/> baru.

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

• Jika awalan namespace yang ditentukan adalah null atau String.Empty, maka awalan untuk URI namespace dari elemen baru diperoleh dari namespace saat ini dalam cakupan. Jika tidak ada awalan namespace yang ditetapkan ke URI namespace yang ditentukan pada cakupan saat ini, maka awalan namespace akan dibuat secara otomatis.

• Metode AppendChildElement ini hanya valid ketika XPathNavigator diposisikan pada simpul akar atau simpul elemen.

• Metode AppendChildElement ini tidak mempengaruhi posisi XPathNavigator.