XmlNode.InsertAfter(XmlNode, XmlNode) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
XmlNode.cs
Origem:
XmlNode.cs
Origem:
XmlNode.cs
Origem:
XmlNode.cs
Origem:
XmlNode.cs

Insere o nó especificado imediatamente após o nó de referência especificado.

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

Parâmetros

newChild
XmlNode

O nó a inserir.

refChild
XmlNode

O nó de referência. newChild é colocado após refChild.

Devoluções

XmlNode

O nó a ser inserido.

Exceções

InvalidOperationException

Este nó é de um tipo que não permite nós filhos do tipo do newChild nó.

É newChild um antepassado deste nó.

ArgumentException

Foi newChild criado a partir de um documento diferente daquele que criou este nó.

O refChild não é filho deste nó.

Este nó é apenas de leitura.

Exemplos

O exemplo seguinte adiciona um novo nó ao documento XML.

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

Observações

Se refChild for null, inserir newChild no início da lista de nós filhos. Todos os conteúdos do newChild são inseridos, na mesma ordem, após refChild. Se já newChild estiver na árvore, é removido da sua posição original e adicionado à sua posição alvo. Para mais informações sobre a inserção de nós, consulte Inserir nós num documento XML.

Se o nó inserido foi criado a partir de outro documento, pode ser usado XmlDocument.ImportNode para importar o nó para o documento atual. O nó importado pode então ser inserido no documento atual.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Notas para Herdeiros

Ao sobrescrever InsertAfter uma classe derivada, para que os eventos sejam levantados corretamente, deve chamar o InsertAfter método da classe base.

Aplica-se a

Ver também