XPathNavigator.InsertBefore 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.

Új testvércsomópontot hoz létre az aktuálisan kijelölt csomópont előtt.

Túlterhelések

Name	Description
InsertBefore()	XmlWriter Egy új testvércsomópont létrehozásához használt objektumot ad vissza az aktuálisan kijelölt csomópont előtt.
InsertBefore(String)	Létrehoz egy új testvércsomópontot az aktuálisan kijelölt csomópont előtt a megadott XML-sztring használatával.
InsertBefore(XmlReader)	Létrehoz egy új testvércsomópontot az aktuálisan kijelölt csomópont előtt a XmlReader megadott objektum XML-tartalmának használatával.
InsertBefore(XPathNavigator)	Létrehoz egy új testvércsomópontot az aktuálisan kijelölt csomópont előtt a XPathNavigator megadott csomópontok használatával.

InsertBefore()

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

XmlWriter Egy új testvércsomópont létrehozásához használt objektumot ad vissza az aktuálisan kijelölt csomópont előtt.

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

Válaszok

XmlWriter

Egy XmlWriter objektum, amellyel új testvércsomópontot hozhat létre az aktuálisan kijelölt csomópont előtt.

Kivételek

InvalidOperationException

A hely nem XPathNavigator teszi lehetővé új testvércsomópont beszúrását az aktuális csomópont elé.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában a rendszer a metódus által visszaadott objektummal pages egy új price elemet szúr be a book fájl első contosoBooks.xml elemének gyermekeleme eléXmlWriter.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)

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 InsertBefore az alábbi fontos megjegyzéseket érdemes figyelembe venni.

Az új testvércsomópont csak az Close objektum metódusának meghívása XmlWriter után lesz beszúrva.
A InsertBefore metódus csak akkor érvényes, ha az XPathNavigator elem, szöveg, feldolgozási utasítás vagy megjegyzéscsomóponton van elhelyezve.
A InsertBefore metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

InsertBefore(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 testvércsomópontot az aktuálisan kijelölt csomópont előtt a megadott XML-sztring használatával.

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)

Paraméterek

newSibling: String

Az új testvércsomópont XML-adatsztringje.

Kivételek

ArgumentNullException

Az XML-sztring paramétere .null

InvalidOperationException

A hely nem XPathNavigator teszi lehetővé új testvércsomópont beszúrását az aktuális csomópont elé.

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 elem lesz beszúrva a price fájl első book elemének gyermekeleme contosoBooks.xml elé.

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)

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ő InsertBefore("<book/>"): . Az aktuális csomópont szövegcsomópontja InsertBefore("book")elé beszúrt "könyv" szöveg sztringje. Ha az XML-sztring több csomópontot tartalmaz, az összes csomópont hozzá lesz adva.

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

A InsertBefore metódus csak akkor érvényes, ha az XPathNavigator elem, szöveg, feldolgozási utasítás vagy megjegyzéscsomóponton van elhelyezve.
A InsertBefore metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

InsertBefore(XmlReader)

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Forrás:: XPathNavigator.cs

Létrehoz egy új testvércsomópontot az aktuálisan kijelölt csomópont előtt a XmlReader megadott objektum XML-tartalmának használatával.

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)

Paraméterek

newSibling: XmlReader

Az XmlReader új testvércsomó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

A hely nem XPathNavigator teszi lehetővé új testvércsomópont beszúrását az aktuális csomópont elé.

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 elem lesz beszúrva a price fájl első book elemének gyermekeleme elé a contosoBooks.xmlXmlReader megadott objektummal. A http://www.contoso.com/books névtér úgy van megadva, hogy az új testvérelem ugyanabban a névtérben legyen beszúrva, mint az XML-dokumentum.

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)

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 InsertBefore 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 InsertBefore metódus csak akkor érvényes, ha az XPathNavigator elem, szöveg, feldolgozási utasítás vagy megjegyzéscsomóponton van elhelyezve.
A InsertBefore metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

InsertBefore(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 testvércsomópontot az aktuálisan kijelölt csomópont előtt a XPathNavigator megadott csomópontok használatával.

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)

Paraméterek

newSibling: XPathNavigator

A XPathNavigator csomóponton elhelyezett objektum, amelyet új testvércsomópontként szeretne hozzáadni.

Kivételek

ArgumentNullException

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

InvalidOperationException

A hely nem XPathNavigator teszi lehetővé új testvércsomópont beszúrását az aktuális csomópont elé.

NotSupportedException

Ez XPathNavigator nem támogatja a szerkesztést.

Példák

Az alábbi példában egy új pages elemet szúrunk be a price fájl első book elemének gyermekeleme elé 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 testvérelem ugyanabban a névtérben legyen beszúrva, mint az XML-dokumentum.

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)

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 InsertBefore 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 InsertBefore metódus csak akkor érvényes, ha az XPathNavigator elem, szöveg, feldolgozási utasítás vagy megjegyzéscsomóponton van elhelyezve.
A InsertBefore metódus nem befolyásolja a XPathNavigator.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?