XmlNode.InsertBefore(XmlNode, XmlNode) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Insere o nó especificado imediatamente antes do nó de referência especificado.

public:
 virtual System::Xml::XmlNode ^ InsertBefore(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);
public virtual System.Xml.XmlNode InsertBefore(System.Xml.XmlNode newChild, System.Xml.XmlNode refChild);
abstract member InsertBefore : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.InsertBefore : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overridable Function InsertBefore (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 antes deste nó.

Devoluções

XmlNode

O nó a ser inserido.

Exceções

InvalidOperationException

O nó atual é 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.InsertBefore(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.InsertBefore(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Observações

Se refChild for null, insira newChild no final da lista de nós filhos. Todos os conteúdos do newChild são inseridos, na mesma ordem, antes refChildde . 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.

Notas para Herdeiros

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

Aplica-se a

Ver também