XPathNavigator.AppendChildElement(String, String, String, String) Yöntem

Tanım

Ad Alanı:

System.Xml.XPath

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XPathNavigator.cs

Belirtilen değerle belirtilen ad alanı ön ekini, yerel adı ve ad alanı URI'sini kullanarak geçerli düğümün alt düğüm listesinin sonunda yeni bir alt öğe düğümü oluşturur.

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)

Parametreler

prefix

String

Yeni alt öğe düğümünün ad alanı ön eki (varsa).

localName

String

Yeni alt öğe düğümünün yerel adı (varsa).

namespaceURI

String

Yeni alt öğe düğümünün ad alanı URI'si (varsa). Empty ve null eşdeğerdir.

value

String

Yeni alt öğe düğümünün değeri. veya Empty geçirilirse null boş bir öğe oluşturulur.

Özel durumlar

InvalidOperationException

konumundaki geçerli düğüm XPathNavigator , kök düğüm veya öğe düğümü değildir.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte, dosyadaki ilk pages öğenin alt öğeleri listesine yeni book bir alt öğe contosoBooks.xml eklenir.

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)

Örnek, contosoBooks.xml dosyasını giriş olarak alır.

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

Açıklamalar

Alt düğümün eklenmesi, yeni düğümü geçerli düğüm için alt düğüm listesinin sonuna ekler. Örneğin, bir öğe düğümü için üç alt düğüm mevcut olduğunda, eklenen düğüm dördüncü alt düğüm olur. Alt düğüm yoksa yeni bir alt düğüm oluşturulur.

Ad alanı ön eki ve URI değerleri yöntemi veya LookupPrefix yöntemi kullanılarak LookupNamespace elde edilebilir. Örneğin, aşağıdaki söz dizimi kapsam içi ad alanını xmlns:bk=http://www.contoso.com/bookskullanarak bir alt öğe ekler:

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

Bu, yeni alt <bk:pages/> öğeyi oluşturur.

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır AppendChildElement .

• Belirtilen ad alanı öneki veya nulliseString.Empty, yeni öğenin ad alanı URI'sinin ön eki kapsam içindeki geçerli ad alanından alınır. Geçerli kapsamda belirtilen ad alanı URI'sine atanmış bir ad alanı ön eki yoksa, otomatik olarak bir ad alanı ön eki oluşturulur.

• AppendChildElement yöntemi yalnızca , kök düğümde veya bir öğe düğümünde konumlandırıldığında XPathNavigator geçerlidir.

• yöntemi, AppendChildElement konumunu XPathNavigatoretkilemez.