XPathNavigator.PrependChild Metoda

Definice

Obor názvů:: System.Xml.XPath

Sestavení:: netstandard.dll, System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XPath.dll

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu.

Přetížení

Name	Description
PrependChild()	XmlWriter Vrátí objekt použitý k vytvoření nového podřízeného uzlu na začátku seznamu podřízených uzlů aktuálního uzlu.
PrependChild(String)	Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí zadaného řetězce XML.
PrependChild(XmlReader)	Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí obsahu XML zadaného objektu XmlReader .
PrependChild(XPathNavigator)	Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí uzlů v zadaném objektu XPathNavigator .

PrependChild()

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

XmlWriter Vrátí objekt použitý k vytvoření nového podřízeného uzlu na začátku seznamu podřízených uzlů aktuálního uzlu.

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

Návraty

XmlWriter

Objekt XmlWriter použitý k vytvoření nového podřízeného uzlu na začátku seznamu podřízených uzlů aktuálního uzlu.

Výjimky

InvalidOperationException

Aktuální uzel, na který XPathNavigator je umístěn, neumožňuje předběžné vytvoření nového podřízeného uzlu.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

Příklady

V následujícím příkladu je nový pages podřízený prvek předzálohován na začátek seznamu podřízených elementů prvního book elementu contosoBooks.xml v souboru pomocí objektu XmlWriter vráceného PrependChild z metody.

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)

Příklad vezme contosoBooks.xml soubor 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ředpendání podřízeného uzlu přidá nový uzel na začátek seznamu podřízených uzlů pro aktuální uzel. Pokud například existují tři podřízené uzly pro prvek, stane se předpendovaný uzel prvním podřízeným uzlem. Pokud neexistují žádné podřízené uzly, vytvoří se nový podřízený uzel.

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

Nový podřízený uzel se nevloží, dokud Close nebude volána metoda objektu XmlWriter .
Metoda PrependChild je platná pouze v případech, kdy XPathNavigator je umístěn na uzlu elementu.
Metoda PrependChild nemá vliv na pozici XPathNavigator.

Platí pro

PrependChild(String)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí zadaného řetězce XML.

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)

Parametry

newChild: String

Datový řetězec XML pro nový podřízený uzel.

Výjimky

ArgumentNullException

Parametr řetězce XML je null.

InvalidOperationException

Aktuální uzel, na který XPathNavigator je umístěn, neumožňuje předběžné vytvoření nového podřízeného uzlu.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

XmlException

Parametr řetězce XML není ve správném formátu.

Příklady

V následujícím příkladu je nový pages podřízený prvek před začátkem seznamu podřízených prvků prvního book prvku v contosoBooks.xml souboru.

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)

Příklad vezme contosoBooks.xml soubor 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

Pokud chcete vytvořit nový uzel elementu, zahrňte do parametru řetězce XML veškerou syntaxi XML. Řetězec nového book uzlu je PrependChild("<book/>"). Řetězec pro připojení textu "book" k textovému uzlu aktuálního uzlu je PrependChild("book"). Pokud řetězec XML obsahuje více uzlů, přidají se všechny uzly.

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

Metoda PrependChild je platná pouze v případech, kdy XPathNavigator je umístěn na uzlu elementu.
Metoda PrependChild nemá vliv na pozici XPathNavigator.

Platí pro

PrependChild(XmlReader)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí obsahu XML zadaného objektu XmlReader .

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)

Parametry

newChild: XmlReader

Objekt XmlReader umístěný v datech XML pro nový podřízený uzel.

Výjimky

ArgumentException

Objekt XmlReader je ve stavu chyby nebo je zavřený.

ArgumentNullException

Parametr objektu XmlReader je null.

InvalidOperationException

Aktuální uzel, na který XPathNavigator je umístěn, neumožňuje předběžné vytvoření nového podřízeného uzlu.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

XmlException

Obsah XML parametru objektu XmlReader není ve správném formátu.

Příklady

V následujícím příkladu je nový pages podřízený prvek předzálohován na začátek seznamu podřízených elementů prvního book prvku v contosoBooks.xml souboru pomocí zadaného objektu XmlReader . Obor http://www.contoso.com/books názvů je zadán tak, aby byl nový podřízený prvek předzálohován pomocí stejného oboru názvů jako dokument 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");

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)

Příklad vezme contosoBooks.xml soubor 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ři použití PrependChild této metody je potřeba vzít v úvahu následující důležité poznámky.

XmlReader Pokud je objekt umístěn v posloupnosti uzlů XML, všechny uzly v sekvenci se přidají.
Metoda PrependChild je platná pouze v případech, kdy XPathNavigator je umístěn na uzlu elementu.
Metoda PrependChild nemá vliv na pozici XPathNavigator.

Platí pro

PrependChild(XPathNavigator)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový podřízený uzel na začátku seznamu podřízených uzlů aktuálního uzlu pomocí uzlů v zadaném objektu 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)

Parametry

newChild: XPathNavigator

Objekt XPathNavigator umístěný na uzlu, který se má přidat jako nový podřízený uzel.

Výjimky

ArgumentNullException

Parametr objektu XPathNavigator je null.

InvalidOperationException

Aktuální uzel, na který XPathNavigator je umístěn, neumožňuje předběžné vytvoření nového podřízeného uzlu.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

Příklady

V následujícím příkladu je nový pages podřízený prvek před začátkem seznamu podřízených prvků prvního book prvku v contosoBooks.xml souboru pomocí uzlu obsaženého v zadaném objektu XPathNavigator . Obor http://www.contoso.com/books názvů je zadán tak, aby byl nový podřízený prvek předzálohován pomocí stejného oboru názvů jako dokument 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");

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)

Příklad vezme contosoBooks.xml soubor 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ři použití PrependChild této metody je potřeba vzít v úvahu následující důležité poznámky.

XPathNavigator Pokud je objekt umístěn v posloupnosti uzlů XML, všechny uzly v sekvenci se přidají.
Metoda PrependChild je platná pouze v případech, kdy XPathNavigator je umístěn na uzlu elementu.
Metoda PrependChild nemá vliv na pozici XPathNavigator.

Platí pro

Váš názor

Byla tato stránka užitečná?