Sdílet prostřednictvím


XPathNavigator.PrependChild Metoda

Definice

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

Přetížení

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

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

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

Nepodporuje XPathNavigator úpravy.

Příklady

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

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

XmlWriter^ pages = navigator->PrependChild();
pages->WriteElementString("pages", "100");
pages->Close();

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

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 přebírá 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ředsazení podřízeného uzlu přidá nový uzel na začátek seznamu podřízených uzlů pro aktuální uzel. Pokud například pro prvek existují tři podřízené uzly, stane se předpřipravený uzel prvním podřízeným uzlem. Pokud neexistují žádné podřízené uzly, vytvoří se nový podřízený uzel.

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

Platí pro

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.

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

Parametr řetězce XML je null.

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

Nepodporuje XPathNavigator úpravy.

Parametr řetězce XML není správně vytvořen.

Příklady

V následujícím příkladu je nový pages podřízený prvek předem vložen na začátek seznamu podřízených prvků prvního book elementu contosoBooks.xml v souboru.

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

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.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 přebírá 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ředsazení podřízeného uzlu přidá nový uzel na začátek seznamu podřízených uzlů pro aktuální uzel. Pokud například pro prvek existují tři podřízené uzly, stane se předpřipravený uzel prvním podřízeným uzlem. Pokud neexistují žádné podřízené uzly, vytvoří se nový podřízený uzel.

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žívání metody je potřeba vzít v PrependChild úvahu následující důležité poznámky.

Platí pro

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 .

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ý na datech XML pro nový podřízený uzel.

Výjimky

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

Parametr XmlReader objektu je null.

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

Nepodporuje XPathNavigator úpravy.

Obsah xml parametru objektu XmlReader není správně formátován.

Příklady

V následujícím příkladu je nový pages podřízený prvek předem uveden na začátek seznamu podřízených elementů prvního book elementu contosoBooks.xml v 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ředem připravený pomocí stejného oboru názvů jako dokument XML.

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

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

navigator->PrependChild(pages);

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

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 přebírá 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ředsazení podřízeného uzlu přidá nový uzel na začátek seznamu podřízených uzlů pro aktuální uzel. Pokud například pro prvek existují tři podřízené uzly, stane se předpřipravený uzel prvním podřízeným uzlem. Pokud neexistují žádné podřízené uzly, vytvoří se nový podřízený uzel.

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

Platí pro

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 .

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

Parametr objektu XPathNavigator je null.

Aktuální uzel XPathNavigator , na který je umístěný, neumožňuje předem vytvořit nový podřízený uzel.

Nepodporuje XPathNavigator úpravy.

Příklady

V následujícím příkladu je nový pages podřízený prvek předem vložen na začátek seznamu podřízených prvků prvního book prvku v contosoBooks.xml souboru pomocí uzlu obsaženého v objektu zadaném XPathNavigator . Obor http://www.contoso.com/books názvů je zadán tak, aby byl nový podřízený prvek předem připravený pomocí stejného oboru názvů jako dokument XML.

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

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

navigator->PrependChild(childNodesNavigator);

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

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

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

Platí pro