XPathNavigator.AppendChildElement(String, String, String, String) Metoda

Definice

Obor názvů:

System.Xml.XPath

Sestavení:

System.Xml.ReaderWriter.dll

Zdroj:

XPathNavigator.cs

Vytvoří nový uzel podřízeného prvku na konci seznamu podřízených uzlů aktuálního uzlu pomocí předpony oboru názvů, místního názvu a identifikátoru URI oboru názvů zadaných se zadanou hodnotou.

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)

Parametry

prefix

String

Předpona oboru názvů nového uzlu podřízeného prvku (pokud existuje).

localName

String

Místní název nového uzlu podřízeného prvku (pokud existuje).

namespaceURI

String

Identifikátor URI oboru názvů nového uzlu podřízeného prvku (pokud existuje). Empty a null jsou ekvivalentní.

value

String

Hodnota nového uzlu podřízeného prvku. Pokud Empty jsou předány nebo null , vytvoří se prázdný element.

Výjimky

InvalidOperationException

Aktuální uzel, XPathNavigator na který je umístěn, není kořenový uzel ani uzel prvku.

NotSupportedException

Nástroj XPathNavigator nepodporuje úpravy.

Příklady

V následujícím příkladu je nový pages podřízený prvek připojen k seznamu podřízených elementů prvního book prvku v contosoBooks.xml souboru.

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)

V příkladu se contosoBooks.xml soubor používá jako vstup.

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

Poznámky

Připojení podřízeného uzlu přidá nový uzel na konec seznamu podřízených uzlů pro aktuální uzel. Pokud například existují tři podřízené uzly pro uzel prvku, připojený uzel se stane čtvrtým podřízeným uzlem. Pokud neexistují žádné podřízené uzly, vytvoří se nový podřízený uzel.

Hodnoty předpony oboru názvů a identifikátoru URI je možné získat pomocí LookupPrefix metody nebo LookupNamespace metody . Například následující syntaxe připojí podřízený prvek pomocí oboru názvů v oboru :xmlns:bk=http://www.contoso.com/books

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

Tím se vytvoří nový podřízený <bk:pages/> prvek.

Při použití metody je potřeba vzít v úvahu následující důležité poznámky AppendChildElement .

• Pokud je null zadaná předpona oboru názvů nebo String.Empty, získá se předpona pro identifikátor URI oboru názvů nového elementu z aktuálních oborů názvů v oboru názvů. Pokud není k zadanému identifikátoru URI oboru názvů v aktuálním oboru názvů přiřazena žádná předpona oboru názvů, automaticky se vygeneruje předpona oboru názvů.

• Metoda AppendChildElement je platná pouze v XPathNavigator případě, že je umístěn na kořenovém uzlu nebo uzlu prvku.

• Metoda AppendChildElement nemá vliv na pozici metody XPathNavigator.