¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
AppendChildElement (Método)
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

XPathNavigator.AppendChildElement (Método)

Crea un nuevo nodo de elemento secundario al final de la lista de nodos secundarios del nodo actual mediante el prefijo de espacio de nombres, el nombre local y el URI de espacio de nombres especificados con el valor seleccionado.

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

public virtual void AppendChildElement(
	string prefix,
	string localName,
	string namespaceURI,
	string value
)

Parámetros

prefix
Tipo: System.String
Prefijo del espacio de nombres del nuevo nodo de elemento secundario (si lo hay).
localName
Tipo: System.String
Nombre local del nuevo nodo de elemento secundario (si lo hay).
namespaceURI
Tipo: System.String
Identificador URI de espacio de nombres del nuevo nodo de elemento secundario (si lo hay). Empty y null son equivalentes.
value
Tipo: System.String
Valor del nuevo nodo de elemento secundario. Si se pasan Empty o null, se crea un elemento vacío.

ExcepciónCondición
InvalidOperationException

El nodo actual donde se encuentra XPathNavigator no es el nodo raíz ni un nodo de elemento.

NotSupportedException

El XPathNavigator no admite la edición.

Al anexar un nodo secundario, el nuevo nodo se agrega al final de la lista de nodos secundarios del nodo actual. Por ejemplo, cuando existen tres nodos secundarios para un nodo de elemento, el nodo anexado pasa a ser el cuarto nodo secundario. Si no existe ningún nodo secundario, se creará uno nuevo.

Los valores de URI y el prefijo de espacio de nombres se pueden obtener utilizando los métodos LookupPrefix o LookupNamespace. Por ejemplo, la sintaxis siguiente anexa un elemento secundario utilizando el espacio de nombres xmlns:bk=http://www.contoso.com/books en el ámbito:

navigator.AppendChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)

Esto crea el nuevo elemento <bk:pages/> secundario.

A la hora de utilizar el método AppendChildElement, debe tener en cuenta las siguientes consideraciones:

  • Si el prefijo del espacio de nombres especificado es null o String.Empty, el prefijo del URI de espacio de nombres del nuevo elemento se obtiene a partir de los espacios de nombres actuales en el ámbito. Si no hay ningún prefijo de espacio de nombres asignado al URI de espacio de nombres especificado en el ámbito actual, se genera automáticamente un prefijo del espacio de nombres.

  • El método AppendChildElement sólo es válido cuando el XPathNavigator está situado en un nodo raíz o un nodo de elemento.

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

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


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.AppendChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

Console.WriteLine(navigator.OuterXml);


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


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


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft