XPathNavigator.PrependChild Método

Definición

Espacio de nombres:

System.Xml.XPath

Ensamblado:

System.Xml.ReaderWriter.dll

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual.

Sobrecargas

PrependChild()	Devuelve un objeto XmlWriter utilizado para crear un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual.
PrependChild(String)	Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual usando la cadena XML especificada.
PrependChild(XmlReader)	Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante el contenido XML del objeto XmlReader especificado.
PrependChild(XPathNavigator)	Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante los nodos del objeto XPathNavigator especificado.

PrependChild()

Source:

XPathNavigator.cs

Devuelve un objeto XmlWriter utilizado para crear un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual.

public:
 virtual System::Xml::XmlWriter ^ PrependChild();

public virtual System.Xml.XmlWriter PrependChild ();

abstract member PrependChild : unit -> System.Xml.XmlWriter
override this.PrependChild : unit -> System.Xml.XmlWriter

Public Overridable Function PrependChild () As XmlWriter

Devoluciones

XmlWriter

Objeto XmlWriter usado para crear un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual.

Excepciones

InvalidOperationException

El nodo actual en el que se coloca el XPathNavigator no permite anteponer un nuevo nodo secundario.

NotSupportedException

XPathNavigator no admite la edición.

Ejemplos

En el ejemplo siguiente, se antepone un nuevo pages elemento secundario al principio de la lista de elementos secundarios del primer book elemento del contosoBooks.xml archivo mediante el XmlWriter objeto devuelto por el PrependChild método .

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");

XmlWriter^ pages = navigator->PrependChild();
pages->WriteElementString("pages", "100");
pages->Close();

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");

XmlWriter pages = navigator.PrependChild();
pages.WriteElementString("pages", "100");
pages.Close();

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")

Dim pages As XmlWriter = navigator.PrependChild()
pages.WriteElementString("pages", "100")
pages.Close()

Console.WriteLine(navigator.OuterXml)

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

<?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>  

Comentarios

Prepending a child node agrega el nuevo nodo al principio de la lista de nodos secundarios para el nodo actual. Por ejemplo, cuando existen tres nodos secundarios para un elemento, el nodo antepuesto se convierte en el primer nodo secundario. Si no existe ningún nodo secundario, se crea un nuevo nodo secundario.

A continuación se muestran notas importantes que se deben tener en cuenta al usar el PrependChild método .

• El nuevo nodo secundario no se inserta hasta que se llama al Close método del XmlWriter objeto .

• El PrependChild método solo es válido cuando XPathNavigator se coloca en un nodo de elemento.

• El PrependChild método no afecta a la posición de XPathNavigator.

PrependChild(String)

Source:

XPathNavigator.cs

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual usando la cadena XML especificada.

public:
 virtual void PrependChild(System::String ^ newChild);

public virtual void PrependChild (string newChild);

abstract member PrependChild : string -> unit
override this.PrependChild : string -> unit

Public Overridable Sub PrependChild (newChild As String)

Parámetros

newChild

String

Cadena de datos XML del nuevo nodo secundario.

Excepciones

ArgumentNullException

El parámetro de cadena XML es null.

InvalidOperationException

El nodo actual en el que se coloca XPathNavigator no permite anteponer un nuevo nodo secundario.

NotSupportedException

XPathNavigator no admite la edición.

XmlException

El parámetro de cadena XML no está bien formado.

Ejemplos

En el ejemplo siguiente, se antepone un nuevo pages elemento secundario al principio de la lista de elementos secundarios del primer book elemento del contosoBooks.xml archivo.

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->PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

<?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>  

Comentarios

Prepending a child node agrega el nuevo nodo al principio de la lista de nodos secundarios para el nodo actual. Por ejemplo, cuando existen tres nodos secundarios para un elemento, el nodo antepuesto se convierte en el primer nodo secundario. Si no existe ningún nodo secundario, se crea un nuevo nodo secundario.

Para crear un nuevo nodo de elemento, incluya toda la sintaxis XML en el parámetro de cadena XML. La cadena de un nuevo book nodo es PrependChild("<book/>"). La cadena para anexar el texto "book" al nodo de texto del nodo actual es PrependChild("book"). Si la cadena XML contiene varios nodos, se agregan todos los nodos.

A continuación se muestran notas importantes que se deben tener en cuenta al usar el PrependChild método .

• El PrependChild método solo es válido cuando XPathNavigator se coloca en un nodo de elemento.

• El PrependChild método no afecta a la posición de XPathNavigator.

PrependChild(XmlReader)

Source:

XPathNavigator.cs

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante el contenido XML del objeto XmlReader especificado.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);

public virtual void PrependChild (System.Xml.XmlReader newChild);

abstract member PrependChild : System.Xml.XmlReader -> unit
override this.PrependChild : System.Xml.XmlReader -> unit

Public Overridable Sub PrependChild (newChild As XmlReader)

Parámetros

newChild

XmlReader

Objeto XmlReader colocado en los datos XML del nuevo nodo secundario.

Excepciones

ArgumentException

El objeto XmlReader está en un estado de error o cerrado.

ArgumentNullException

El parámetro del objeto XmlReader es null.

InvalidOperationException

El nodo actual en el que se coloca XPathNavigator no permite anteponer un nuevo nodo secundario.

NotSupportedException

XPathNavigator no admite la edición.

XmlException

El contenido XML del parámetro de objeto XmlReader no está bien formado.

Ejemplos

En el ejemplo siguiente, se antepone un nuevo pages elemento secundario al principio de la lista de elementos secundarios del primer book elemento del contosoBooks.xml archivo mediante el XmlReader objeto especificado. El http://www.contoso.com/books espacio de nombres se especifica para que el nuevo elemento secundario se anteponga con el mismo espacio de nombres que el documento XML.

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");

XmlReader^ pages = XmlReader::Create(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->PrependChild(pages);

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");

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.PrependChild(pages);

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")

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.PrependChild(pages)

Console.WriteLine(navigator.OuterXml)

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

<?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>  

Comentarios

Prepending a child node agrega el nuevo nodo al principio de la lista de nodos secundarios para el nodo actual. Por ejemplo, cuando existen tres nodos secundarios para un elemento, el nodo antepuesto se convierte en el primer nodo secundario. Si no existe ningún nodo secundario, se crea un nuevo nodo secundario.

A continuación se muestran notas importantes que se deben tener en cuenta al usar el PrependChild método .

• Si el XmlReader objeto se coloca en una secuencia de nodos XML, se agregan todos los nodos de la secuencia.

• El PrependChild método solo es válido cuando XPathNavigator se coloca en un nodo de elemento.

• El PrependChild método no afecta a la posición de XPathNavigator.

PrependChild(XPathNavigator)

Source:

XPathNavigator.cs

Crea un nuevo nodo secundario al principio de la lista de nodos secundarios del nodo actual mediante los nodos del objeto XPathNavigator especificado.

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void PrependChild (System.Xml.XPath.XPathNavigator newChild);

abstract member PrependChild : System.Xml.XPath.XPathNavigator -> unit
override this.PrependChild : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub PrependChild (newChild As XPathNavigator)

Parámetros

newChild

XPathNavigator

Objeto XPathNavigator colocado en el nodo para agregarlo como nuevo nodo secundario.

Excepciones

ArgumentNullException

El parámetro del objeto XPathNavigator es null.

InvalidOperationException

El nodo actual en el que se coloca XPathNavigator no permite anteponer un nuevo nodo secundario.

NotSupportedException

XPathNavigator no admite la edición.

Ejemplos

En el ejemplo siguiente, se antepone un nuevo pages elemento secundario al principio de la lista de elementos secundarios del primer book elemento del contosoBooks.xml archivo mediante el nodo contenido en el XPathNavigator objeto especificado. El http://www.contoso.com/books espacio de nombres se especifica para que el nuevo elemento secundario se anteponga con el mismo espacio de nombres que el documento XML.

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");

XmlDocument^ childNodes = gcnew XmlDocument();
childNodes->Load(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator^ childNodesNavigator = childNodes->CreateNavigator();

navigator->PrependChild(childNodesNavigator);

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");

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.PrependChild(childNodesNavigator);

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")

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.PrependChild(childNodesNavigator)

Console.WriteLine(navigator.OuterXml)

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

<?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>  

Comentarios

Prepending a child node agrega el nuevo nodo al principio de la lista de nodos secundarios para el nodo actual. Por ejemplo, cuando existen tres nodos secundarios para un elemento, el nodo antepuesto se convierte en el primer nodo secundario. Si no existe ningún nodo secundario, se crea un nuevo nodo secundario.

A continuación se muestran notas importantes que se deben tener en cuenta al usar el PrependChild método .

• Si el XPathNavigator objeto se coloca en una secuencia de nodos XML, se agregan todos los nodos de la secuencia.

• El PrependChild método solo es válido cuando XPathNavigator se coloca en un nodo de elemento.

• El PrependChild método no afecta a la posición de XPathNavigator.