XPathNavigator.Clone Método

Definición

Espacio de nombres:

System.Xml.XPath

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XPathNavigator.cs

Cuando se reemplaza en una clase derivada, crea una nueva XPathNavigator posición en el mismo nodo que este XPathNavigator.

public:
 abstract System::Xml::XPath::XPathNavigator ^ Clone();

public abstract System.Xml.XPath.XPathNavigator Clone();

abstract member Clone : unit -> System.Xml.XPath.XPathNavigator

Public MustOverride Function Clone () As XPathNavigator

Devoluciones

XPathNavigator

Nuevo XPathNavigator situado en el mismo nodo que este XPathNavigator.

Ejemplos

En el ejemplo siguiente se obtienen todos los títulos del libro creados por Herman Melville.

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

// Select all books authored by Melville.
XPathNodeIterator nodes = navigator.Select("descendant::book[author/last-name='Melville']");

while (nodes.MoveNext())
{
    // Clone the navigator returned by the Current property.
    // Use the cloned navigator to get the title element.
    XPathNavigator clone = nodes.Current.Clone();
    clone.MoveToFirstChild();
    Console.WriteLine("Book title: {0}", clone.Value);
}

Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

' Select all books authored by Melville.
Dim nodes As XPathNodeIterator = navigator.Select("descendant::book[author/last-name='Melville']")

While nodes.MoveNext()
    ' Clone the navigator returned by the Current property. 
    ' Use the cloned navigator to get the title element.
    Dim clone As XPathNavigator = nodes.Current.Clone()
    clone.MoveToFirstChild()
    Console.WriteLine("Book title: {0}", clone.Value)
End While

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

<?xml version="1.0" encoding="utf-8" ?>
<bookstore>
    <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

El Clone método es especialmente útil junto con .XPathNodeIterator XPathNodeIterator Se usa para iterar en un conjunto de nodos seleccionado y contiene una Current propiedad que devuelve una XPathNavigator posición en el nodo de contexto de XPathNodeIterator. Sin embargo, no se puede usar el XPathNavigator devuelto por la Current propiedad para alejarse del conjunto de nodos. En su lugar, clone el devuelto XPathNavigator y use el navegador clonado para realizar movimientos adicionales.

El clon XPathNavigator no se ve afectado por los cambios posteriores en el original XPathNavigator.