XPathNavigator.InsertAfter Metoda

Definice

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel.Creates a new sibling node after the currently selected node.

Přetížení

InsertAfter(XPathNavigator)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí uzlů v XPathNavigator zadaném objektu.Creates a new sibling node after the currently selected node using the nodes in the XPathNavigator object specified.

InsertAfter(XmlReader)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí obsahu XML XmlReader zadaného objektu.Creates a new sibling node after the currently selected node using the XML contents of the XmlReader object specified.

InsertAfter()

Vrátí XmlWriter objekt, který se používá k vytvoření nového uzlu na stejné úrovni za aktuálně vybraného uzlu.Returns an XmlWriter object used to create a new sibling node after the currently selected node.

InsertAfter(String)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí zadaného řetězce XML.Creates a new sibling node after the currently selected node using the XML string specified.

InsertAfter(XPathNavigator)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí uzlů v XPathNavigator zadaném objektu.Creates a new sibling node after the currently selected node using the nodes in the XPathNavigator object specified.

public:
 virtual void InsertAfter(System::Xml::XPath::XPathNavigator ^ newSibling);
public virtual void InsertAfter (System.Xml.XPath.XPathNavigator newSibling);
abstract member InsertAfter : System.Xml.XPath.XPathNavigator -> unit
override this.InsertAfter : System.Xml.XPath.XPathNavigator -> unit
Public Overridable Sub InsertAfter (newSibling As XPathNavigator)

Parametry

newSibling
XPathNavigator

XPathNavigatorObjekt umístěný na uzlu, který se má přidat jako nový uzel na stejné úrovni.An XPathNavigator object positioned on the node to add as the new sibling node.

Výjimky

XPathNavigatorParametr objektu je null .The XPathNavigator object parameter is null.

Pozice XPathNavigator neumožňuje vložit nový uzel na stejné úrovni, který bude vložen za aktuální uzel.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

Nepodporuje XPathNavigator úpravy.The XPathNavigator does not support editing.

Příklady

V následujícím příkladu pages je nový prvek vložen za price podřízený prvek prvního book prvku v contosoBooks.xml souboru pomocí uzlu obsaženého v XPathNavigator zadaném objektu.In the following example a new pages element is inserted after the price child element of the first book element in the contosoBooks.xml file using the node contained in the XPathNavigator object specified. http://www.contoso.com/booksObor názvů je určen tak, aby nový element na stejné úrovni byl vložen pomocí stejného oboru názvů jako dokument XML.The http://www.contoso.com/books namespace is specified so that the new sibling element is inserted using the same namespace as the XML document.

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->MoveToChild("price", "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->InsertAfter(childNodesNavigator);

navigator->MoveToParent();
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.MoveToChild("price", "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.InsertAfter(childNodesNavigator);

navigator.MoveToParent();
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.MoveToChild("price", "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.InsertAfter(childNodesNavigator)

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Tento příklad přebírá contosoBooks.xml soubor jako vstup.The example takes the contosoBooks.xml file as an input.

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

V následujícím seznamu jsou důležité poznámky, které je potřeba vzít v úvahu při použití InsertAfter metody.The following are important notes to consider when using the InsertAfter method.

  • Pokud XmlReader je objekt umístěn přes sekvenci uzlů XML, jsou přidány všechny uzly v sekvenci.If the XmlReader object is positioned over a sequence of XML nodes, all the nodes in the sequence are added.

  • InsertAfterMetoda je platná pouze v případě, že XPathNavigator je umístěna v uzlu element, text, instrukce zpracování nebo komentář.The InsertAfter method is valid only when the XPathNavigator is positioned on an element, text, processing instruction, or comment node.

  • InsertAfterMetoda nemá vliv na pozici XPathNavigator .The InsertAfter method does not affect the position of the XPathNavigator.

Platí pro

InsertAfter(XmlReader)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí obsahu XML XmlReader zadaného objektu.Creates a new sibling node after the currently selected node using the XML contents of the XmlReader object specified.

public:
 virtual void InsertAfter(System::Xml::XmlReader ^ newSibling);
public virtual void InsertAfter (System.Xml.XmlReader newSibling);
abstract member InsertAfter : System.Xml.XmlReader -> unit
override this.InsertAfter : System.Xml.XmlReader -> unit
Public Overridable Sub InsertAfter (newSibling As XmlReader)

Parametry

newSibling
XmlReader

XmlReaderObjekt umístěný na datech XML pro nový uzel na stejné úrovni.An XmlReader object positioned on the XML data for the new sibling node.

Výjimky

XmlReaderObjekt je v chybovém stavu nebo uzavřen.The XmlReader object is in an error state or closed.

XmlReaderParametr objektu je null .The XmlReader object parameter is null.

Pozice XPathNavigator neumožňuje vložit nový uzel na stejné úrovni, který bude vložen za aktuální uzel.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

Nepodporuje XPathNavigator úpravy.The XPathNavigator does not support editing.

Obsah XML XmlReader parametru objektu nemá správný formát.The XML contents of the XmlReader object parameter is not well-formed.

Příklady

V následujícím příkladu pages je nový prvek vložen za price podřízený prvek prvního book prvku v contosoBooks.xml souboru pomocí XmlReader zadaného objektu.In the following example a new pages element is inserted after the price child element of the first book element in the contosoBooks.xml file using the XmlReader object specified. http://www.contoso.com/booksObor názvů je určen tak, aby nový element na stejné úrovni byl vložen pomocí stejného oboru názvů jako dokument XML.The http://www.contoso.com/books namespace is specified so that the new sibling element is inserted using the same namespace as the XML document.

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->MoveToChild("price", "http://www.contoso.com/books");

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

navigator->InsertAfter(pages);

navigator->MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books");

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

navigator.InsertAfter(pages);

navigator.MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books")

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

navigator.InsertAfter(pages)

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Tento příklad přebírá contosoBooks.xml soubor jako vstup.The example takes the contosoBooks.xml file as an input.

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

V následujícím seznamu jsou důležité poznámky, které je potřeba vzít v úvahu při použití InsertAfter metody.The following are important notes to consider when using the InsertAfter method.

  • Pokud XmlReader je objekt umístěn přes sekvenci uzlů XML, jsou přidány všechny uzly v sekvenci.If the XmlReader object is positioned over a sequence of XML nodes, all the nodes in the sequence are added.

  • InsertAfterMetoda je platná pouze v případě, že XPathNavigator je umístěna v uzlu element, text, instrukce zpracování nebo komentář.The InsertAfter method is valid only when the XPathNavigator is positioned on an element, text, processing instruction, or comment node.

  • InsertAfterMetoda nemá vliv na pozici XPathNavigator .The InsertAfter method does not affect the position of the XPathNavigator.

Platí pro

InsertAfter()

Vrátí XmlWriter objekt, který se používá k vytvoření nového uzlu na stejné úrovni za aktuálně vybraného uzlu.Returns an XmlWriter object used to create a new sibling node after the currently selected node.

public:
 virtual System::Xml::XmlWriter ^ InsertAfter();
public virtual System.Xml.XmlWriter InsertAfter ();
abstract member InsertAfter : unit -> System.Xml.XmlWriter
override this.InsertAfter : unit -> System.Xml.XmlWriter
Public Overridable Function InsertAfter () As XmlWriter

Návraty

XmlWriter

XmlWriterObjekt, který slouží k vytvoření nového uzlu na stejné úrovni za aktuálně vybraného uzlu.An XmlWriter object used to create a new sibling node after the currently selected node.

Výjimky

Pozice XPathNavigator neumožňuje vložit nový uzel na stejné úrovni, který bude vložen za aktuální uzel.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

Nepodporuje XPathNavigator úpravy.The XPathNavigator does not support editing.

Příklady

V následujícím příkladu pages je nový prvek vložen za price podřízený prvek prvního book prvku v contosoBooks.xml souboru pomocí XmlWriter objektu vráceného InsertAfter metodou.In the following example a new pages element is inserted after the price child element of the first book element in the contosoBooks.xml file using the XmlWriter object returned by the InsertAfter method.

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->MoveToChild("price", "http://www.contoso.com/books");

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

navigator->MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books");

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

navigator.MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books")

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

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Tento příklad přebírá contosoBooks.xml soubor jako vstup.The example takes the contosoBooks.xml file as an input.

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

V následujícím seznamu jsou důležité poznámky, které je potřeba vzít v úvahu při použití InsertAfter metody.The following are important notes to consider when using the InsertAfter method.

Platí pro

InsertAfter(String)

Vytvoří nový uzel na stejné úrovni za aktuálně vybraný uzel pomocí zadaného řetězce XML.Creates a new sibling node after the currently selected node using the XML string specified.

public:
 virtual void InsertAfter(System::String ^ newSibling);
public virtual void InsertAfter (string newSibling);
abstract member InsertAfter : string -> unit
override this.InsertAfter : string -> unit
Public Overridable Sub InsertAfter (newSibling As String)

Parametry

newSibling
String

Datový řetězec XML pro nový uzel na stejné úrovni.The XML data string for the new sibling node.

Výjimky

Parametr řetězce XML je null .The XML string parameter is null.

Pozice XPathNavigator neumožňuje vložit nový uzel na stejné úrovni, který bude vložen za aktuální uzel.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

Nepodporuje XPathNavigator úpravy.The XPathNavigator does not support editing.

Parametr řetězce XML nemá správný formát.The XML string parameter is not well-formed.

Příklady

V následujícím příkladu pages je nový prvek vložen za price podřízený prvek prvního book prvku v contosoBooks.xml souboru.In the following example a new pages element is inserted after the price child element of the first book element in the contosoBooks.xml file.

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->MoveToChild("price", "http://www.contoso.com/books");

navigator->InsertAfter("<pages>100</pages>");

navigator->MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books");

navigator.InsertAfter("<pages>100</pages>");

navigator.MoveToParent();
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.MoveToChild("price", "http://www.contoso.com/books")

navigator.InsertAfter("<pages>100</pages>")

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Tento příklad přebírá contosoBooks.xml soubor jako vstup.The example takes the contosoBooks.xml file as an input.

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

Chcete-li vytvořit nový uzel elementu, zahrňte všechny syntaxe XML do parametru řetězce XML.To create a new element node, include all XML syntax in the XML string parameter. Řetězec pro nový book uzel je InsertAfter("<book/>") .The string for a new book node is InsertAfter("<book/>"). Řetězec pro vložení textu "book" za textovým uzlem aktuálního uzlu InsertAfter("book")The string for inserting the text "book" after the current node's text node is InsertAfter("book"). Pokud řetězec XML obsahuje více uzlů, jsou přidány všechny uzly.If the XML string contains multiple nodes, all nodes are added.

V následujícím seznamu jsou důležité poznámky, které je potřeba vzít v úvahu při použití InsertAfter metody.The following are important notes to consider when using the InsertAfter method.

Platí pro