Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
 Versión imprimible       Enviar     
Evaluar y enviar comentarios
MSDN
MSDN Library
System.Xml
 PrependChild (Método)

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
XmlNode.PrependChild (Método)
Agrega el nodo especificado al principio de la lista de nodos secundarios de este nodo.

Espacio de nombres: System.Xml
Ensamblado: System.Xml (en system.xml.dll)

Visual Basic (Declaración)
Public Overridable Function PrependChild ( _
    newChild As XmlNode _
) As XmlNode
Visual Basic (Uso)
Dim instance As XmlNode
Dim newChild As XmlNode
Dim returnValue As XmlNode

returnValue = instance.PrependChild(newChild)
C#
public virtual XmlNode PrependChild (
    XmlNode newChild
)
C++
public:
virtual XmlNode^ PrependChild (
    XmlNode^ newChild
)
J#
public XmlNode PrependChild (
    XmlNode newChild
)
JScript
public function PrependChild (
    newChild : XmlNode
) : XmlNode
XAML
No aplicable.

Parámetros

newChild

Nodo que se va a agregar. Si es un XmlDocumentFragment, todo el contenido del fragmento de documento se desplaza a la lista de nodos secundarios de este nodo.

Valor devuelto

Nodo agregado.
Tipo de excepciónCondición

InvalidOperationException

Este nodo es de un tipo que no admite nodos secundarios del tipo del nodo newChild.

newChild es un nodo primario de este nodo.

ArgumentException

newChild se creó a partir de un documento diferente del que creó este nodo.

Este nodo es de sólo lectura.

Si newChild ya está en el árbol, primero se quita.

Si el nodo que se va a insertar se creó desde otro documento, se puede utilizar XmlDocument.ImportNode para importar el nodo al documento actual. El nodo importado se puede insertar en el documento actual.

Este método es una extensión de Microsoft a Document Object Model (DOM).

Notas para los herederos: Cuando se reemplaza PrependChild en una clase derivada, para que los eventos se desencadenen correctamente, el usuario debe llamar al método PrependChild de la clase base.

En el ejemplo siguiente se agrega un nuevo nodo al documento XML.

Visual Basic
Option Explicit
Option Strict

Imports System
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.PrependChild(elem)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main 
End Class 'Sample
C#
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.PrependChild(elem);

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

  }
}
C++
#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->PrependChild( elem );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}
J#
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"
            + "<title>Pride And Prejudice</title>"
            + "</book>");

        XmlNode root = doc.get_DocumentElement();

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

        //Add the node to the document.
        root.PrependChild(elem);

        Console.WriteLine("Display the modified XML...");
        doc.Save(Console.get_Out());
    } //main 
} //Sample

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0, 1.0

XNA Framework

Compatible con: 1.0
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker