XPathNavigator.Clone Metodo

Definizione

Spazio dei nomi:

System.Xml.XPath

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XPathNavigator.cs

Quando sottoposto a override in una classe derivata, crea un nuovo XPathNavigator posizionato nello stesso nodo di questo XPathNavigatoroggetto .

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

Restituisce

XPathNavigator

XPathNavigator Nuovo posizionato nello stesso nodo di questo XPathNavigatoroggetto .

Esempio

L'esempio seguente ottiene tutti i titoli dei libri creati da 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

L'esempio accetta il books.xml file come input.

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

Commenti

Il Clone metodo è particolarmente utile in combinazione con .XPathNodeIterator Un XPathNodeIterator oggetto viene usato per scorrere un set di nodi selezionato e contiene una proprietà che restituisce un CurrentXPathNavigator oggetto posizionato sul nodo di contesto dell'oggetto XPathNodeIterator. Tuttavia, l'oggetto XPathNavigator restituito dalla Current proprietà non può essere utilizzato per allontanarsi dal set di nodi. Clonare invece l'oggetto restituito e usare lo strumento di spostamento clonato XPathNavigator per eseguire eventuali spostamenti aggiuntivi.

Il clonato XPathNavigator non è interessato dalle successive modifiche apportate all'originale XPathNavigator.