XPathNavigator.PrependChild Metódus

Definíció

Névtér:: System.Xml.XPath

Szerelvények:: netstandard.dll, System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.XPath.dll

Szerelvény:: System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának elején.

Túlterhelések

Name	Description
PrependChild()	XmlWriter Egy új gyermekcsomópont létrehozásához használt objektumot ad vissza az aktuális csomópont gyermekcsomópontjainak listájának elején.
PrependChild(String)	Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott XML-sztring használatával.
PrependChild(XmlReader)	Új gyermekcsomópontot hoz létre az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott objektum XML-tartalmának XmlReader használatával.
PrependChild(XPathNavigator)	Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott objektum csomópontjaival XPathNavigator .

PrependChild()

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

XmlWriter Egy új gyermekcsomópont létrehozásához használt objektumot ad vissza az aktuális csomópont gyermekcsomópontjainak listájának elején.

public:
 virtual System::Xml::XmlWriter ^ PrependChild();

public virtual System.Xml.XmlWriter PrependChild();

abstract member PrependChild : unit -> System.Xml.XmlWriter
override this.PrependChild : unit -> System.Xml.XmlWriter

Public Overridable Function PrependChild () As XmlWriter

Válaszok

XmlWriter

Új XmlWriter gyermekcsomópont létrehozásához használt objektum az aktuális csomópont gyermekcsomópontjainak listájának elején.

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 a contosoBooks.xmlXmlWriter metódusból PrependChild visszaadott objektummal.

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");

XmlWriter pages = navigator.PrependChild();
pages.WriteElementString("pages", "100");
pages.Close();

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")

Dim pages As XmlWriter = navigator.PrependChild()
pages.WriteElementString("pages", "100")
pages.Close()

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 módszer használatakor PrependChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Az új gyermekcsomópont csak az Close objektum metódusának meghívása XmlWriter után lesz beszúrva.
A PrependChild metódus csak akkor érvényes, ha az XPathNavigator elemcsomóponton van elhelyezve.
A PrependChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

PrependChild(String)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott XML-sztring használatával.

public:
 virtual void PrependChild(System::String ^ newChild);

public virtual void PrependChild(string newChild);

abstract member PrependChild : string -> unit
override this.PrependChild : string -> unit

Public Overridable Sub PrependChild (newChild As String)

Paraméterek

newChild: String

Az új gyermekcsomópont XML-adatsztringje.

Kivételek

ArgumentNullException

Az XML-sztring paramétere .null

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.

XmlException

Az XML-sztring paraméter nem megfelelően formázott.

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.PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>")

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

Új elemcsomópont létrehozásához adja meg az XML-sztring paraméter összes XML-szintaxisát. Az új book csomópont sztringje a következő PrependChild("<book/>"): . A "book" szövegnek az aktuális csomópont szövegcsomóponthoz való hozzáfűzésére szolgáló sztring az PrependChild("book"). Ha az XML-sztring több csomópontot tartalmaz, az összes csomópont hozzá lesz adva.

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

A PrependChild metódus csak akkor érvényes, ha az XPathNavigator elemcsomóponton van elhelyezve.
A PrependChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

PrependChild(XmlReader)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Új gyermekcsomópontot hoz létre az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott objektum XML-tartalmának XmlReader használatával.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);

public virtual void PrependChild(System.Xml.XmlReader newChild);

abstract member PrependChild : System.Xml.XmlReader -> unit
override this.PrependChild : System.Xml.XmlReader -> unit

Public Overridable Sub PrependChild (newChild As XmlReader)

Paraméterek

newChild: XmlReader

Az XmlReader új gyermekcsomópont XML-adatain elhelyezett objektum.

Kivételek

ArgumentException

Az XmlReader objektum hibaállapotban vagy bezárt állapotban van.

ArgumentNullException

Az XmlReader objektumparaméter a következő null: .

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.

XmlException

Az objektumparaméter XML-tartalma XmlReader nem megfelelően formázott.

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 a contosoBooks.xmlXmlReader megadott objektummal. A http://www.contoso.com/books névtér úgy van megadva, hogy az új gyermekelem az XML-dokumentum nevével megegyező névtérrel legyen előre felfűzve.

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");

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.PrependChild(pages);

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")

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.PrependChild(pages)

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 módszer használatakor PrependChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Ha az XmlReader objektum XML-csomópontok sorozata fölé van helyezve, a rendszer hozzáadja a sorozat összes csomópontját.
A PrependChild metódus csak akkor érvényes, ha az XPathNavigator elemcsomóponton van elhelyezve.
A PrependChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

PrependChild(XPathNavigator)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új gyermekcsomópontot az aktuális csomópont gyermekcsomópontjainak listájának elején a megadott objektum csomópontjaival XPathNavigator .

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void PrependChild(System.Xml.XPath.XPathNavigator newChild);

abstract member PrependChild : System.Xml.XPath.XPathNavigator -> unit
override this.PrependChild : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub PrependChild (newChild As XPathNavigator)

Paraméterek

newChild: XPathNavigator

Új XPathNavigator gyermekcsomópontként hozzáadni kívánt objektum a csomóponton.

Kivételek

ArgumentNullException

Az XPathNavigator objektumparaméter a következő null: .

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

A következő példában egy új pages gyermekelem elő van állítva a fájl első book elemének gyermekelemeinek listájának elejére a contosoBooks.xml megadott objektumban XPathNavigator található csomópont használatával. A http://www.contoso.com/books névtér úgy van megadva, hogy az új gyermekelem az XML-dokumentum nevével megegyező névtérrel legyen előre felfűzve.

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");

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.PrependChild(childNodesNavigator);

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")

Dim childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.PrependChild(childNodesNavigator)

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 módszer használatakor PrependChild az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Ha az XPathNavigator objektum XML-csomópontok sorozata fölé van helyezve, a rendszer hozzáadja a sorozat összes csomópontját.
A PrependChild metódus csak akkor érvényes, ha az XPathNavigator elemcsomóponton van elhelyezve.
A PrependChild metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?