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

Definicja

Przestrzeń nazw:

System.Xml.XPath

Zestaw:

System.Xml.ReaderWriter.dll

Źródło:

XPathNavigator.cs

Tworzy nowy węzeł elementu podrzędnego na końcu listy węzłów podrzędnych bieżącego węzła przy użyciu prefiksu przestrzeni nazw, nazwy lokalnej i identyfikatora URI przestrzeni nazw określonej z określoną wartością.

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

Prefiks przestrzeni nazw nowego węzła elementu podrzędnego (jeśli istnieje).

localName

String

Lokalna nazwa nowego węzła elementu podrzędnego (jeśli istnieje).

namespaceURI

String

Identyfikator URI przestrzeni nazw nowego węzła elementu podrzędnego (jeśli istnieje). Empty i null są równoważne.

value

String

Wartość nowego węzła podrzędnego. Jeśli Empty element zostanie przekazany lub null zostanie przekazany, zostanie utworzony pusty element.

Wyjątki

InvalidOperationException

Bieżący węzeł, na XPathNavigator który znajduje się, nie jest węzłem głównym ani węzłem elementu.

NotSupportedException

Element XPathNavigator nie obsługuje edycji.

Przykłady

W poniższym przykładzie nowy pages element podrzędny jest dołączany do listy elementów podrzędnych pierwszego book elementu w contosoBooks.xml pliku.

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)

W przykładzie plik jest contosoBooks.xml pobierany jako dane wejściowe.

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

Uwagi

Dołączanie węzła podrzędnego powoduje dodanie nowego węzła na końcu listy węzłów podrzędnych dla bieżącego węzła. Na przykład gdy istnieją trzy węzły podrzędne dla węzła elementu, dołączony węzeł staje się czwartym węzłem podrzędnym. Jeśli nie istnieją żadne węzły podrzędne, zostanie utworzony nowy węzeł podrzędny.

Prefiks przestrzeni nazw i wartości identyfikatora URI można uzyskać przy użyciu LookupPrefix metody lub LookupNamespace metody . Na przykład następująca składnia dołącza element podrzędny przy użyciu przestrzeni nazw xmlns:bk=http://www.contoso.com/booksw zakresie :

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

Spowoduje to utworzenie nowego elementu podrzędnego <bk:pages/> .

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z AppendChildElement metody .

• Jeśli określony prefiks przestrzeni nazw to null lub String.Empty, prefiks identyfikatora URI przestrzeni nazw nowego elementu jest uzyskiwany z bieżących przestrzeni nazw w zakresie. Jeśli nie ma prefiksu przestrzeni nazw przypisanego do określonego identyfikatora URI przestrzeni nazw w bieżącym zakresie, prefiks przestrzeni nazw jest generowany automatycznie.

• Metoda jest prawidłowa AppendChildElement tylko wtedy, gdy XPathNavigator element znajduje się w węźle głównym lub w węźle elementu.

• Metoda AppendChildElement nie ma wpływu na położenie XPathNavigatorobiektu .