XPathNavigator.InsertBefore 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ý uzel na stejné úrovni před aktuálně vybraným uzlem.

Přetížení

Name	Description
InsertBefore()	XmlWriter Vrátí objekt použitý k vytvoření nového uzlu na stejné úrovni před aktuálně vybraným uzlem.
InsertBefore(String)	Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí zadaného řetězce XML.
InsertBefore(XmlReader)	Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí obsahu XML zadaného objektu XmlReader .
InsertBefore(XPathNavigator)	Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí uzlů v zadaném XPathNavigator seznamu.

InsertBefore()

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 uzlu na stejné úrovni před aktuálně vybraným uzlem.

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

public virtual System.Xml.XmlWriter InsertBefore();

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

Public Overridable Function InsertBefore () As XmlWriter

Návraty

XmlWriter

Objekt XmlWriter použitý k vytvoření nového uzlu na stejné úrovni před aktuálně vybraným uzlem.

Výjimky

InvalidOperationException

Umístění XPathNavigator neumožní vložení nového uzlu na stejné úrovni před aktuální uzel.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

Příklady

V následujícím příkladu je vložen nový pages prvek před price podřízený prvek prvního book prvku v contosoBooks.xml souboru pomocí objektu XmlWriter vráceného metodou InsertBefore .

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.InsertBefore();
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.InsertBefore()
pages.WriteElementString("pages", "100")
pages.Close()

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

Nový uzel na stejné úrovni není vložen, dokud Close není volána metoda objektu XmlWriter .
Metoda InsertBefore je platná pouze v případě XPathNavigator , že je umístěn na element, text, zpracování instrukce nebo uzel komentáře.
Metoda InsertBefore nemá vliv na pozici XPathNavigator.

Platí pro

InsertBefore(String)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí zadaného řetězce XML.

public:
 virtual void InsertBefore(System::String ^ newSibling);

public virtual void InsertBefore(string newSibling);

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

Public Overridable Sub InsertBefore (newSibling As String)

Parametry

newSibling: String

Datový řetězec XML pro nový uzel na stejné úrovni.

Výjimky

ArgumentNullException

Parametr řetězce XML je null.

InvalidOperationException

Umístění XPathNavigator neumožní vložení nového uzlu na stejné úrovni před aktuální uzel.

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 vložen nový pages prvek před price podřízený prvek 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.MoveToChild("price", "http://www.contoso.com/books");

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

navigator.MoveToParent()
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 InsertBefore("<book/>"). Řetězec pro vložení textu "book" před textový uzel aktuálního uzlu je InsertBefore("book"). Pokud řetězec XML obsahuje více uzlů, přidají se všechny uzly.

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

Metoda InsertBefore je platná pouze v případě XPathNavigator , že je umístěn na element, text, zpracování instrukce nebo uzel komentáře.
Metoda InsertBefore nemá vliv na pozici XPathNavigator.

Platí pro

InsertBefore(XmlReader)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí obsahu XML zadaného objektu XmlReader .

public:
 virtual void InsertBefore(System::Xml::XmlReader ^ newSibling);

public virtual void InsertBefore(System.Xml.XmlReader newSibling);

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

Public Overridable Sub InsertBefore (newSibling As XmlReader)

Parametry

newSibling: XmlReader

Objekt XmlReader umístěný na datech XML pro nový uzel na stejné úrovni.

Výjimky

ArgumentException

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

ArgumentNullException

Parametr objektu XmlReader je null.

InvalidOperationException

Umístění XPathNavigator neumožní vložení nového uzlu na stejné úrovni před aktuální uzel.

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 vložen nový pages prvek před price podřízený prvek 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ý element na stejné úrovni vložen 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");
navigator.MoveToChild("price", "http://www.contoso.com/books");

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

navigator.InsertBefore(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.InsertBefore(pages)

navigator.MoveToParent()
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í InsertBefore 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 InsertBefore je platná pouze v případě XPathNavigator , že je umístěn na element, text, zpracování instrukce nebo uzel komentáře.
Metoda InsertBefore nemá vliv na pozici XPathNavigator.

Platí pro

InsertBefore(XPathNavigator)

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Zdroj:: XPathNavigator.cs

Vytvoří nový uzel na stejné úrovni před aktuálně vybraným uzlem pomocí uzlů v zadaném XPathNavigator seznamu.

public:
 virtual void InsertBefore(System::Xml::XPath::XPathNavigator ^ newSibling);

public virtual void InsertBefore(System.Xml.XPath.XPathNavigator newSibling);

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

Public Overridable Sub InsertBefore (newSibling As XPathNavigator)

Parametry

newSibling: XPathNavigator

Objekt XPathNavigator umístěný na uzlu, který se má přidat jako nový uzel na stejné úrovni.

Výjimky

ArgumentNullException

Parametr objektu XPathNavigator je null.

InvalidOperationException

Umístění XPathNavigator neumožní vložení nového uzlu na stejné úrovni před aktuální uzel.

NotSupportedException

Nepodporuje XPathNavigator úpravy.

Příklady

V následujícím příkladu je vložen nový pages prvek před price podřízený prvek 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ý element na stejné úrovni vložen 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");
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.InsertBefore(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.InsertBefore(childNodesNavigator)

navigator.MoveToParent()
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í InsertBefore 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 InsertBefore je platná pouze v případě XPathNavigator , že je umístěn na element, text, zpracování instrukce nebo uzel komentáře.
Metoda InsertBefore nemá vliv na pozici XPathNavigator.

Platí pro

Váš názor

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