XPathNavigator.PrependChildElement(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

Új gyermekelemet hoz létre az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott értékkel megadott névtérelőtag, helyi név és névtér URI használatával.

public:
 virtual void PrependChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);

public virtual void PrependChildElement(string? prefix, string localName, string? namespaceURI, string? value);

abstract member PrependChildElement : string * string * string * string -> unit
override this.PrependChildElement : string * string * string * string -> unit

Public Overridable Sub PrependChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Paraméterek

prefix

String

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

localName

String

Az új gyermekelem helyi neve (ha van ilyen).

namespaceURI

String

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

value

String

Az új gyermekelem é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 teszi lehetővé egy új gyermekcsomópont előpendálását.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában egy új pages gyermekelem elő van állítva a fájl első book elemének gyermekelemeinek listájának elejére 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.PrependChildElement(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.PrependChildElement(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 előpendálása hozzáadja az új csomópontot az aktuális csomóponthoz tartozó gyermekcsomópontok listájának elejéhez. Ha például három gyermekcsomópont létezik egy elemhez, az előre felfűzött csomópont lesz az első 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 vagy LookupPrefix metódus LookupNamespace használatával kérhetők le. Az alábbi szintaxis például a hatókörön belüli névtér xmlns:bk="http://www.contoso.com/books"használatával előszűr egy gyermekelemet:

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

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

A módszer használatakor PrependChildElement 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 PrependChildElement metódus csak akkor érvényes, ha az XPathNavigator elemcsomóponton van elhelyezve.

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