XPathNavigator.AppendChildElement(String, String, String, String) Metódus

Definíció

Névtér:

System.Xml.XPath

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XPathNavigator.cs

Létrehoz egy új gyermekelem-csomópontot az aktuális csomópont gyermekcsomópontjainak listájának végén a megadott értékkel megadott névtérelőtag, helyi név és névtér URI használatával.

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)

Paraméterek

prefix

String

Az új gyermekelem-csomópont névtérelőtagja (ha van ilyen).

localName

String

Az új gyermekelem-csomópont helyi neve (ha van ilyen).

namespaceURI

String

Az új gyermekelem-csomópont névterének URI-ja (ha van ilyen). Empty és null egyenértékűek.

value

String

Az új gyermekelem-csomópont értéke. Ha Empty a rendszer átadja vagy null átadja, egy üres elem jön létre.

Kivételek

InvalidOperationException

Az aktuális csomópont XPathNavigator , amelyen elhelyezve van, nem a gyökércsomópont vagy elemcsomópont.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában egy új pages gyermekelem lesz hozzáfűzve a fájl első book elemének gyermekelemeinek listájához contosoBooks.xml .

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)

A példa bemenetként használja a contosoBooks.xml fájlt.

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

Megjegyzések

A gyermekcsomópont hozzáfűzése hozzáadja az új csomópontot az aktuális csomóponthoz tartozó gyermekcsomópontok listájának végéhez. Ha például három gyermekcsomópont létezik egy elemcsomóponthoz, a hozzáfűzött csomópont lesz a negyedik gyermekcsomópont. Ha nincsenek gyermekcsomópontok, akkor létrejön egy új gyermekcsomópont.

A névtér előtagja és az URI-értékek a metódus vagy a LookupPrefixLookupNamespace metódus használatával kérhetők le. Az alábbi szintaxis például hozzáfűz egy gyermekelemet a hatókörön belüli névtér xmlns:bk=http://www.contoso.com/bookshasználatával:

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

Ezzel létrehozza az új gyermekelemet <bk:pages/> .

A módszer használatakor AppendChildElement az alábbi fontos megjegyzéseket érdemes figyelembe venni.

• Ha a megadott null névtérelőtag vagy String.Empty, akkor az új elem névtér URI előtagját a rendszer a hatókörben lévő aktuális névterekből szerzi be. Ha az aktuális hatókörben nincs hozzárendelve névtérelőtag a megadott névtér URI-hoz, a rendszer automatikusan létrehoz egy névtérelőtagot.

• A AppendChildElement metódus csak akkor érvényes, ha a XPathNavigator gyökércsomóponton vagy egy elemcsomóponton van elhelyezve.

• A AppendChildElement metódus nem befolyásolja a XPathNavigator.