XmlNode.InsertAfter(XmlNode, XmlNode) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kodlar:
System.Xml.dll, System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll
Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs

Belirtilen düğümü belirtilen başvuru düğümünden hemen sonra ekler.

public:
 virtual System::Xml::XmlNode ^ InsertAfter(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);
public virtual System.Xml.XmlNode InsertAfter (System.Xml.XmlNode newChild, System.Xml.XmlNode refChild);
public virtual System.Xml.XmlNode? InsertAfter (System.Xml.XmlNode newChild, System.Xml.XmlNode? refChild);
abstract member InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overridable Function InsertAfter (newChild As XmlNode, refChild As XmlNode) As XmlNode

Parametreler

newChild
XmlNode

Eklenecek düğüm.

refChild
XmlNode

Başvuru düğümü. newChild , sonrasında refChildyerleştirilir.

Döndürülenler

XmlNode

Eklenen düğüm.

Özel durumlar

InvalidOperationException

Bu düğüm, düğüm türünün alt düğümlerine izin vermeyen bir türdür newChild .

newChild bu düğümün bir atasıdır.

ArgumentException

, newChild bu düğümü oluşturan belgeden farklı bir belgeden oluşturulmuştur.

refChild bu düğümün alt öğesi değil.

Bu düğüm salt okunurdur.

Örnekler

Aşağıdaki örnek XML belgesine yeni bir düğüm ekler.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   XmlNode^ root = doc->DocumentElement;
   
   //Create a new node.
   XmlElement^ elem = doc->CreateElement( "price" );
   elem->InnerText = "19.95";
   
   //Add the node to the document.
   root->InsertAfter( elem, root->FirstChild );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.InsertAfter(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        Dim root As XmlNode = doc.DocumentElement
        
        'Create a new node.
        Dim elem As XmlElement = doc.CreateElement("price")
        elem.InnerText = "19.95"
        
        'Add the node to the document.
        root.InsertAfter(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Açıklamalar

ise refChildnull, alt düğümler listesinin başına ekleyin newChild . öğesinin newChild tüm içeriği, sonra aynı sırayla refChildeklenir. newChild zaten ağaçtaysa, özgün konumundan kaldırılır ve hedef konumuna eklenir. Düğüm ekleme hakkında daha fazla bilgi için bkz. XML Belgesine Düğüm Ekleme.

Eklenen düğüm başka bir belgeden oluşturulduysa, düğümü geçerli belgeye aktarmak için kullanabilirsiniz XmlDocument.ImportNode . İçeri aktarılan düğüm daha sonra geçerli belgeye eklenebilir.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Microsoft bir uzantısıdır.

Devralanlara Notlar

Türetilmiş bir sınıfta geçersiz kılınırken InsertAfter , olayların doğru şekilde tetiklenmesi için temel sınıfın InsertAfter yöntemini çağırmanız gerekir.

Şunlara uygulanır

Ayrıca bkz.