XPathNavigator.InsertBefore Metode

Definisi

Ruang nama:: System.Xml.XPath

Rakitan:: netstandard.dll, System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.XPath.dll

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat simpul saudara baru sebelum simpul yang saat ini dipilih.

Overload

Nama	Deskripsi
InsertBefore()	Mengembalikan objek yang XmlWriter digunakan untuk membuat simpul saudara baru sebelum simpul yang saat ini dipilih.
InsertBefore(String)	Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan string XML yang ditentukan.
InsertBefore(XmlReader)	Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan konten XML objek yang XmlReader ditentukan.
InsertBefore(XPathNavigator)	Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan simpul dalam XPathNavigator yang ditentukan.

InsertBefore()

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Mengembalikan objek yang XmlWriter digunakan untuk membuat simpul saudara baru sebelum simpul yang saat ini dipilih.

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

Mengembalikan

XmlWriter

Objek yang XmlWriter digunakan untuk membuat simpul saudara baru sebelum simpul yang saat ini dipilih.

Pengecualian

InvalidOperationException

Posisi XPathNavigator tidak memperbolehkan simpul saudara baru dimasukkan sebelum simpul saat ini.

NotSupportedException

XPathNavigator Tidak mendukung pengeditan.

Contoh

Dalam contoh berikut, elemen baru pages disisipkan sebelum price elemen turunan dari elemen pertama book dalam contosoBooks.xml file menggunakan objek yang XmlWriter dikembalikan oleh InsertBefore metode .

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)

Contoh mengambil contosoBooks.xml file sebagai 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>

Keterangan

Berikut ini adalah catatan penting yang perlu dipertimbangkan InsertBefore saat menggunakan metode .

Simpul saudara baru tidak dimasukkan sampai Close metode objek dipanggil XmlWriter .
Metode InsertBefore ini hanya valid ketika XPathNavigator diposisikan pada elemen, teks, instruksi pemrosesan, atau simpul komentar.
Metode InsertBefore ini tidak memengaruhi posisi XPathNavigator.

Berlaku untuk

InsertBefore(String)

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan string XML yang ditentukan.

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)

Parameter

newSibling: String

String data XML untuk simpul saudara baru.

Pengecualian

ArgumentNullException

Parameter string XML adalah null.

InvalidOperationException

Posisi XPathNavigator tidak memperbolehkan simpul saudara baru dimasukkan sebelum simpul saat ini.

NotSupportedException

XPathNavigator Tidak mendukung pengeditan.

XmlException

Parameter string XML tidak terbentuk dengan baik.

Contoh

Dalam contoh berikut, elemen baru pages disisipkan sebelum elemen turunan price dari elemen pertama book dalam file contosoBooks.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");

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)

Contoh mengambil contosoBooks.xml file sebagai 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>

Keterangan

Untuk membuat simpul elemen baru, sertakan semua sintaks XML dalam parameter string XML. String untuk simpul baru book adalah InsertBefore("<book/>"). String untuk menyisipkan teks "buku" sebelum simpul teks simpul saat ini adalah InsertBefore("book"). Jika string XML berisi beberapa simpul, semua simpul ditambahkan.

Berikut ini adalah catatan penting yang perlu dipertimbangkan InsertBefore saat menggunakan metode .

Metode InsertBefore ini hanya valid ketika XPathNavigator diposisikan pada elemen, teks, instruksi pemrosesan, atau simpul komentar.
Metode InsertBefore ini tidak memengaruhi posisi XPathNavigator.

Berlaku untuk

InsertBefore(XmlReader)

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan konten XML objek yang XmlReader ditentukan.

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)

Parameter

newSibling: XmlReader

Objek XmlReader yang diposisikan pada data XML untuk simpul saudara baru.

Pengecualian

ArgumentException

Objek XmlReader dalam status kesalahan atau tertutup.

ArgumentNullException

Parameter XmlReader objek adalah null.

InvalidOperationException

Posisi XPathNavigator tidak memperbolehkan simpul saudara baru dimasukkan sebelum simpul saat ini.

NotSupportedException

XPathNavigator Tidak mendukung pengeditan.

XmlException

Konten XML dari XmlReader parameter objek tidak terbentuk dengan baik.

Contoh

Dalam contoh berikut, elemen baru pages disisipkan sebelum price elemen turunan dari elemen pertama book dalam contosoBooks.xml file menggunakan XmlReader objek yang ditentukan. Namespace http://www.contoso.com/books ditentukan sehingga elemen saudara baru disisipkan menggunakan namespace yang sama dengan dokumen 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)

Contoh mengambil contosoBooks.xml file sebagai 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>

Keterangan

Berikut ini adalah catatan penting yang perlu dipertimbangkan InsertBefore saat menggunakan metode .

XmlReader Jika objek diposisikan di atas urutan simpul XML, semua simpul dalam urutan ditambahkan.
Metode InsertBefore ini hanya valid ketika XPathNavigator diposisikan pada elemen, teks, instruksi pemrosesan, atau simpul komentar.
Metode InsertBefore ini tidak memengaruhi posisi XPathNavigator.

Berlaku untuk

InsertBefore(XPathNavigator)

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Sumber:: XPathNavigator.cs

Membuat simpul saudara baru sebelum simpul yang saat ini dipilih menggunakan simpul dalam XPathNavigator yang ditentukan.

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)

Parameter

newSibling: XPathNavigator

Objek XPathNavigator yang diposisikan pada simpul untuk ditambahkan sebagai simpul saudara baru.

Pengecualian

ArgumentNullException

Parameter XPathNavigator objek adalah null.

InvalidOperationException

Posisi XPathNavigator tidak memperbolehkan simpul saudara baru dimasukkan sebelum simpul saat ini.

NotSupportedException

XPathNavigator Tidak mendukung pengeditan.

Contoh

Dalam contoh berikut, elemen baru pages disisipkan sebelum price elemen turunan dari elemen pertama book dalam contosoBooks.xml file menggunakan simpul yang terkandung dalam XPathNavigator objek yang ditentukan. Namespace http://www.contoso.com/books ditentukan sehingga elemen saudara baru disisipkan menggunakan namespace yang sama dengan dokumen 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)

Contoh mengambil contosoBooks.xml file sebagai 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>

Keterangan

Berikut ini adalah catatan penting yang perlu dipertimbangkan InsertBefore saat menggunakan metode .

XPathNavigator Jika objek diposisikan di atas urutan simpul XML, semua simpul dalam urutan ditambahkan.
Metode InsertBefore ini hanya valid ketika XPathNavigator diposisikan pada elemen, teks, instruksi pemrosesan, atau simpul komentar.
Metode InsertBefore ini tidak memengaruhi posisi XPathNavigator.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?