XPathNavigator.Clone Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, se crea un nuevo XPathNavigator que se coloca 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.XPathNavigatorPublic MustOverride Function Clone () As XPathNavigatorDevoluciones
Nuevo XPathNavigator que se sitúa 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 = gcnew 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);
}
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 como entrada el archivo books.xml.
<?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, el XPathNavigator devuelto por la Current propiedad no se puede usar para alejarse del conjunto de nodos. En su lugar, clone el devuelto XPathNavigator y use el navegador clonado para realizar cualquier movimiento adicional.
El clon XPathNavigator no se ve afectado por los cambios posteriores en el original XPathNavigator.
