XPathNavigator.InsertAfter Yöntem

Tanım

Şu anda seçili olan düğümden sonra yeni bir eşdüzey düğüm oluşturur.Creates a new sibling node after the currently selected node.

Aşırı Yüklemeler

InsertAfter(XPathNavigator)

Belirtilen nesnedeki düğümleri kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur XPathNavigator .Creates a new sibling node after the currently selected node using the nodes in the XPathNavigator object specified.

InsertAfter(XmlReader)

Belirtilen nesnenin XML içeriğini kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur XmlReader .Creates a new sibling node after the currently selected node using the XML contents of the XmlReader object specified.

InsertAfter()

XmlWriterŞu anda seçili olan düğümden sonra yeni bir eşdüzey düğüm oluşturmak için kullanılan bir nesne döndürür.Returns an XmlWriter object used to create a new sibling node after the currently selected node.

InsertAfter(String)

Belirtilen XML dizesini kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur.Creates a new sibling node after the currently selected node using the XML string specified.

InsertAfter(XPathNavigator)

Belirtilen nesnedeki düğümleri kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur XPathNavigator .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)

Parametreler

newSibling
XPathNavigator

XPathNavigatorYeni eşdüzey düğüm olarak eklenecek düğüme yerleştirilmiş bir nesne.An XPathNavigator object positioned on the node to add as the new sibling node.

Özel durumlar

XPathNavigatorNesne parametresi null .The XPathNavigator object parameter is null.

Öğesinin konumu, XPathNavigator geçerli düğümden sonra yeni bir eşdüzey düğümün eklenmesine izin vermez.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

, XPathNavigator Düzenlemesini desteklemez.The XPathNavigator does not support editing.

Örnekler

Aşağıdaki örnekte, pages price book contosoBooks.xml belirtilen nesnede bulunan düğümü kullanarak dosyasındaki ilk öğenin alt öğesinden sonra yeni bir öğe eklenir XPathNavigator .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/booksAd alanı, yeni eşdüzey ÖĞENIN XML belgesiyle aynı ad alanı kullanılarak eklenmesi için belirtilir.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)

Örnek, contosoBooks.xml dosyayı bir giriş olarak alır.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>  

Açıklamalar

Yöntemi kullanırken göz önünde bulundurmanız gereken önemli notlar aşağıda verilmiştir InsertAfter .The following are important notes to consider when using the InsertAfter method.

  • XmlReaderNesne BIR XML düğümleri dizisine konumlandırılmışsa dizideki tüm düğümler eklenir.If the XmlReader object is positioned over a sequence of XML nodes, all the nodes in the sequence are added.

  • InsertAfterYöntemi yalnızca XPathNavigator bir öğe, metin, işleme yönergesi veya açıklama düğümüne konumlandırıldığında geçerlidir.The InsertAfter method is valid only when the XPathNavigator is positioned on an element, text, processing instruction, or comment node.

  • InsertAfterYöntemi, konumunu etkilemez XPathNavigator .The InsertAfter method does not affect the position of the XPathNavigator.

Şunlara uygulanır

InsertAfter(XmlReader)

Belirtilen nesnenin XML içeriğini kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur XmlReader .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)

Parametreler

newSibling
XmlReader

XmlReaderYeni eşdüzey düğüm IÇIN XML verilerinde konumlandırılmış bir nesne.An XmlReader object positioned on the XML data for the new sibling node.

Özel durumlar

XmlReaderNesne bir hata durumunda veya kapalı.The XmlReader object is in an error state or closed.

XmlReaderNesne parametresi null .The XmlReader object parameter is null.

Öğesinin konumu, XPathNavigator geçerli düğümden sonra yeni bir eşdüzey düğümün eklenmesine izin vermez.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

, XPathNavigator Düzenlemesini desteklemez.The XPathNavigator does not support editing.

XmlReaderNesne PARAMETRESININ XML içeriği düzgün biçimlendirilmemiş.The XML contents of the XmlReader object parameter is not well-formed.

Örnekler

Aşağıdaki örnekte, pages price book contosoBooks.xml belirtilen nesnesi kullanılarak dosyasındaki ilk öğenin alt öğesinden sonra yeni bir öğe eklenir XmlReader .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/booksAd alanı, yeni eşdüzey ÖĞENIN XML belgesiyle aynı ad alanı kullanılarak eklenmesi için belirtilir.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)

Örnek, contosoBooks.xml dosyayı bir giriş olarak alır.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>  

Açıklamalar

Yöntemi kullanırken göz önünde bulundurmanız gereken önemli notlar aşağıda verilmiştir InsertAfter .The following are important notes to consider when using the InsertAfter method.

  • XmlReaderNesne BIR XML düğümleri dizisine konumlandırılmışsa dizideki tüm düğümler eklenir.If the XmlReader object is positioned over a sequence of XML nodes, all the nodes in the sequence are added.

  • InsertAfterYöntemi yalnızca XPathNavigator bir öğe, metin, işleme yönergesi veya açıklama düğümüne konumlandırıldığında geçerlidir.The InsertAfter method is valid only when the XPathNavigator is positioned on an element, text, processing instruction, or comment node.

  • InsertAfterYöntemi, konumunu etkilemez XPathNavigator .The InsertAfter method does not affect the position of the XPathNavigator.

Şunlara uygulanır

InsertAfter()

XmlWriterŞu anda seçili olan düğümden sonra yeni bir eşdüzey düğüm oluşturmak için kullanılan bir nesne döndürür.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

Döndürülenler

XmlWriter

XmlWriterŞu anda seçili olan düğümden sonra yeni bir eşdüzey düğüm oluşturmak için kullanılan nesne.An XmlWriter object used to create a new sibling node after the currently selected node.

Özel durumlar

Öğesinin konumu, XPathNavigator geçerli düğümden sonra yeni bir eşdüzey düğümün eklenmesine izin vermez.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

, XPathNavigator Düzenlemesini desteklemez.The XPathNavigator does not support editing.

Örnekler

Aşağıdaki örnekte, pages price book contosoBooks.xml XmlWriter yöntemi tarafından döndürülen nesnesi kullanılarak dosyasındaki ilk öğenin alt öğesinden sonra yeni bir öğe eklenir InsertAfter .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)

Örnek, contosoBooks.xml dosyayı bir giriş olarak alır.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>  

Açıklamalar

Yöntemi kullanırken göz önünde bulundurmanız gereken önemli notlar aşağıda verilmiştir InsertAfter .The following are important notes to consider when using the InsertAfter method.

Şunlara uygulanır

InsertAfter(String)

Belirtilen XML dizesini kullanarak şu anda seçili olan düğüm sonrasında yeni bir eşdüzey düğüm oluşturur.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)

Parametreler

newSibling
String

Yeni eşdüzey düğüm için XML veri dizesi.The XML data string for the new sibling node.

Özel durumlar

XML dize parametresi null .The XML string parameter is null.

Öğesinin konumu, XPathNavigator geçerli düğümden sonra yeni bir eşdüzey düğümün eklenmesine izin vermez.The position of the XPathNavigator does not allow a new sibling node to be inserted after the current node.

, XPathNavigator Düzenlemesini desteklemez.The XPathNavigator does not support editing.

XML dize parametresi düzgün biçimlendirilmemiş.The XML string parameter is not well-formed.

Örnekler

Aşağıdaki örnekte, pages price dosyasındaki ilk öğenin alt öğesinden sonra yeni bir öğe eklenir book contosoBooks.xml .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)

Örnek, contosoBooks.xml dosyayı bir giriş olarak alır.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>  

Açıklamalar

Yeni bir öğe düğümü oluşturmak için XML dize parametresine tüm XML söz dizimini ekleyin.To create a new element node, include all XML syntax in the XML string parameter. Yeni bir düğüm için dize book InsertAfter("<book/>") .The string for a new book node is InsertAfter("<book/>"). Geçerli düğümün metin düğümünden sonra "Book" metnini eklemeye yönelik dize InsertAfter("book") .The string for inserting the text "book" after the current node's text node is InsertAfter("book"). XML dizesi birden çok düğüm içeriyorsa, tüm düğümler eklenir.If the XML string contains multiple nodes, all nodes are added.

Yöntemi kullanırken göz önünde bulundurmanız gereken önemli notlar aşağıda verilmiştir InsertAfter .The following are important notes to consider when using the InsertAfter method.

Şunlara uygulanır