XPathNavigator.InsertBefore Yöntem

Tanım

Ad Alanı:: System.Xml.XPath

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.XPath.dll

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

Aşırı Yüklemeler

Name	Description
InsertBefore()	XmlWriter Seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturmak için kullanılan nesneyi döndürür.
InsertBefore(String)	Belirtilen XML dizesini kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.
InsertBefore(XmlReader)	Belirtilen nesnenin XML içeriğini XmlReader kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.
InsertBefore(XPathNavigator)	Belirtilen düğümlerdeki XPathNavigator düğümleri kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

InsertBefore()

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

XmlWriter Seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturmak için kullanılan nesneyi döndürür.

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

Döndürülenler

XmlWriter

Seçili XmlWriter durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturmak için kullanılan nesne.

Özel durumlar

InvalidOperationException

konumu XPathNavigator , geçerli düğümden önce yeni bir eşdüzey düğümün eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte, yöntemi tarafından pages döndürülen nesnesi kullanılarak price dosyadaki book ilk contosoBooks.xml öğenin alt öğesinden önce XmlWriter yeni InsertBefore bir öğe eklenir.

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)

Örnek, contosoBooks.xml dosyasını giriş olarak alır.

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

Açıklamalar

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır InsertBefore .

Nesnenin yöntemi Close çağrılana XmlWriter kadar yeni eşdüzey düğüm eklenmez.
InsertBefore yöntemi yalnızca öğesinde, metinde, işleme yönergesinde veya açıklama düğümünde konumlandırıldığında XPathNavigator geçerlidir.
yöntemi, InsertBefore konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

InsertBefore(String)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Belirtilen XML dizesini kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

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)

Parametreler

newSibling: String

Yeni eşdüzey düğüm için XML veri dizesi.

Özel durumlar

ArgumentNullException

XML dizesi parametresidir null.

InvalidOperationException

konumu XPathNavigator , geçerli düğümden önce yeni bir eşdüzey düğümün eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

XmlException

XML dizesi parametresi iyi biçimlendirilmemiş.

Örnekler

Aşağıdaki örnekte, pages dosyasındaki ilk price öğenin alt öğesi book önüne yeni bir contosoBooks.xml öğesi eklenir.

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)

Örnek, contosoBooks.xml dosyasını giriş olarak alır.

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

Açıklamalar

Yeni bir öğe düğümü oluşturmak için, XML dizesi parametresine tüm XML söz dizimini ekleyin. Yeni book düğümün dizesi şeklindedir InsertBefore("<book/>"). Geçerli düğümün metin düğümünden önce "book" metnini ekleme dizesi olur InsertBefore("book"). XML dizesi birden çok düğüm içeriyorsa, tüm düğümler eklenir.

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır InsertBefore .

InsertBefore yöntemi yalnızca öğesinde, metinde, işleme yönergesinde veya açıklama düğümünde konumlandırıldığında XPathNavigator geçerlidir.
yöntemi, InsertBefore konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

InsertBefore(XmlReader)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Belirtilen nesnenin XML içeriğini XmlReader kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

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)

Parametreler

newSibling: XmlReader

XmlReader Yeni eşdüzey düğüm için XML verilerine konumlandırılmış bir nesne.

Özel durumlar

ArgumentException

XmlReader Nesne bir hata durumunda veya kapatıldı.

ArgumentNullException

XmlReader nesne parametresidirnull.

InvalidOperationException

konumu XPathNavigator , geçerli düğümden önce yeni bir eşdüzey düğümün eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

XmlException

Nesne parametresinin XmlReader XML içeriği iyi biçimlendirilmemiş.

Örnekler

Aşağıdaki örnekte, belirtilen nesne kullanılarak pages dosyadaki pricebook ilk contosoBooks.xml öğenin alt öğesinden önce yeni XmlReader bir öğe eklenir. Ad http://www.contoso.com/books alanı, yeni eşdüzey öğenin XML belgesiyle aynı ad alanı kullanılarak eklenmesi için belirtilir.

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)

Örnek, contosoBooks.xml dosyasını giriş olarak alır.

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

Açıklamalar

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır InsertBefore .

XmlReader Nesne bir XML düğümleri dizisinin üzerine yerleştirilirse, dizideki tüm düğümler eklenir.
InsertBefore yöntemi yalnızca öğesinde, metinde, işleme yönergesinde veya açıklama düğümünde konumlandırıldığında XPathNavigator geçerlidir.
yöntemi, InsertBefore konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

InsertBefore(XPathNavigator)

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Kaynak:: XPathNavigator.cs

Belirtilen düğümlerdeki XPathNavigator düğümleri kullanarak seçili durumdaki düğümden önce yeni bir eşdüzey düğüm oluşturur.

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)

Parametreler

newSibling: XPathNavigator

XPathNavigator Yeni eşdüzey düğüm olarak eklenecek düğümde konumlandırılan nesne.

Özel durumlar

ArgumentNullException

XPathNavigator nesne parametresidirnull.

InvalidOperationException

konumu XPathNavigator , geçerli düğümden önce yeni bir eşdüzey düğümün eklenmesine izin vermez.

NotSupportedException

XPathNavigator düzenlemeyi desteklemiyor.

Örnekler

Aşağıdaki örnekte, belirtilen nesnede pages bulunan price düğüm kullanılarak dosyadaki book ilk contosoBooks.xml öğenin alt öğesinden önce yeni XPathNavigator bir öğe eklenir. Ad http://www.contoso.com/books alanı, yeni eşdüzey öğenin XML belgesiyle aynı ad alanı kullanılarak eklenmesi için belirtilir.

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)

Örnek, contosoBooks.xml dosyasını giriş olarak alır.

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

Açıklamalar

Yöntemi kullanırken dikkate alınması gereken önemli notlar aşağıdadır InsertBefore .

XPathNavigator Nesne bir XML düğümleri dizisinin üzerine yerleştirilirse, dizideki tüm düğümler eklenir.
InsertBefore yöntemi yalnızca öğesinde, metinde, işleme yönergesinde veya açıklama düğümünde konumlandırıldığında XPathNavigator geçerlidir.
yöntemi, InsertBefore konumunu XPathNavigatoretkilemez.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?