Share via


XPathNavigator.MoveToFollowing Método

Definición

Mueve XPathNavigator al elemento especificado en el orden del documento.

Sobrecargas

MoveToFollowing(XPathNodeType, XPathNavigator)

Mueve el XPathNavigator al siguiente elemento del XPathNodeType especificado, al límite especificado, en el orden del documento.

MoveToFollowing(String, String, XPathNavigator)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados, al límite especificado, en el orden del documento.

MoveToFollowing(XPathNodeType)

Mueve el XPathNavigator al elemento siguiente del XPathNodeType especificado en el orden del documento.

MoveToFollowing(String, String)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados en el orden del documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Mueve el XPathNavigator al siguiente elemento del XPathNodeType especificado, al límite especificado, en el orden del documento.

public:
 virtual bool MoveToFollowing(System::Xml::XPath::XPathNodeType type, System::Xml::XPath::XPathNavigator ^ end);
public virtual bool MoveToFollowing (System.Xml.XPath.XPathNodeType type, System.Xml.XPath.XPathNavigator? end);
public virtual bool MoveToFollowing (System.Xml.XPath.XPathNodeType type, System.Xml.XPath.XPathNavigator end);
abstract member MoveToFollowing : System.Xml.XPath.XPathNodeType * System.Xml.XPath.XPathNavigator -> bool
override this.MoveToFollowing : System.Xml.XPath.XPathNodeType * System.Xml.XPath.XPathNavigator -> bool
Public Overridable Function MoveToFollowing (type As XPathNodeType, end As XPathNavigator) As Boolean

Parámetros

type
XPathNodeType

XPathNodeType del elemento. El XPathNodeType no puede ser Attribute ni Namespace.

end
XPathNavigator

Objeto XPathNavigator situado en el límite del elemento que el XPathNavigator actual no sobrepasa durante la búsqueda del elemento siguiente.

Devoluciones

Boolean

true, si el elemento XPathNavigator se desplaza correctamente; de lo contrario, false.

Ejemplos

En el ejemplo siguiente, XPathNavigator se mueve de la raíz del contosoBooks.xml archivo al elemento siguiente price . Un clon del XPathNavigator objeto se realiza mediante el Clone método . El elemento clonado XPathNavigator, situado en el price elemento, se usará como límite. Los cambios en la posición del clonado XPathNavigator no afectan al original XPathNavigator. El original XPathNavigator se mueve de nuevo a la raíz del contosoBooks.xml archivo mediante el MoveToRoot método . El título y el apellido del autor se recuperan mediante el MoveToFollowing método y un XPathNodeType de Text. El MoveToFollowing método devolverá true hasta que se alcance el límite del price elemento.

    XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
    XPathNavigator^ navigator = document->CreateNavigator();

    navigator->MoveToFollowing("price", "http://www.contoso.com/books");
    XPathNavigator^ boundary = navigator->Clone();

    navigator->MoveToRoot();

while (navigator->MoveToFollowing(XPathNodeType::Text, boundary))
    {
        Console::WriteLine(navigator->OuterXml);
    }
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToFollowing("price", "http://www.contoso.com/books");
XPathNavigator boundary = navigator.Clone();

navigator.MoveToRoot();

while (navigator.MoveToFollowing(XPathNodeType.Text, boundary))
{
    Console.WriteLine(navigator.OuterXml);
}
Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToFollowing("price", "http://www.contoso.com/books")
Dim boundary As XPathNavigator = navigator.Clone()

navigator.MoveToRoot()

While navigator.MoveToFollowing(XPathNodeType.Text, boundary)
    Console.WriteLine(navigator.OuterXml)
End While

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

  • El MoveToFollowing método no se mueve a nodos de atributo o espacio de nombres. Si el valor del XPathNodeType parámetro es Attribute o Namespace, el MoveToFollowing método devuelve false y la posición de no XPathNavigator cambia.

  • Si el XPathNavigator límite pasado como parámetro no se coloca después de la posición del actual XPathNavigator , se omite.

  • Si XPathNavigator el límite pasado como parámetro es null el siguiente nodo con el especificado XPathNodeType se encuentra en orden de documento.

  • Los MoveToFollowing métodos no se pueden usar para moverse a nodos de atributo o espacio de nombres. Si el XPathNavigator límite pasado como parámetro se coloca sobre un nodo de atributo o espacio de nombres, es equivalente al XPathNavigator parámetro de límite que se ha colocado en el primer nodo secundario de su elemento primario. Esto garantiza que este método pueda coincidir con el elemento primario del nodo de atributo o espacio de nombres en el que se coloca el XPathNavigator parámetro de límite.

  • Si el MoveToFollowing método devuelve false, la posición de no XPathNavigator cambia.

Se aplica a

MoveToFollowing(String, String, XPathNavigator)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados, al límite especificado, en el orden del documento.

public:
 virtual bool MoveToFollowing(System::String ^ localName, System::String ^ namespaceURI, System::Xml::XPath::XPathNavigator ^ end);
public virtual bool MoveToFollowing (string localName, string namespaceURI, System.Xml.XPath.XPathNavigator? end);
public virtual bool MoveToFollowing (string localName, string namespaceURI, System.Xml.XPath.XPathNavigator end);
abstract member MoveToFollowing : string * string * System.Xml.XPath.XPathNavigator -> bool
override this.MoveToFollowing : string * string * System.Xml.XPath.XPathNavigator -> bool
Public Overridable Function MoveToFollowing (localName As String, namespaceURI As String, end As XPathNavigator) As Boolean

Parámetros

localName
String

Nombre local del elemento.

namespaceURI
String

Identificador URI de espacio de nombres del elemento.

end
XPathNavigator

Objeto XPathNavigator situado en el límite del elemento que el XPathNavigator actual no sobrepasa durante la búsqueda del elemento siguiente.

Devoluciones

Boolean

true, si el elemento XPathNavigator se desplaza correctamente; de lo contrario, false.

Ejemplos

En el ejemplo siguiente, XPathNavigator se mueve de la raíz del contosoBooks.xml archivo al elemento siguiente book . Un clon del XPathNavigator objeto se realiza mediante el Clone método y se mueve del book elemento al elemento siguiente first-name . El elemento clonado XPathNavigator, situado en el first-name elemento, se usará como límite. Los cambios en la posición del clonado XPathNavigator no afectan al original XPathNavigator. A continuación, el original XPathNavigator intenta moverse al siguiente price elemento mediante el MoveToFollowing método con el límite pasado como parámetro. Este movimiento produce un error porque el siguiente price elemento está más allá del límite. A continuación, el original XPathNavigator intenta moverse al siguiente title elemento que es antes del límite mediante el mismo método y se realiza correctamente.

XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToFollowing("book", "http://www.contoso.com/books");
XPathNavigator^ boundary = navigator->Clone();
boundary->MoveToFollowing("first-name", "http://www.contoso.com/books");

navigator->MoveToFollowing("price", "http://www.contoso.com/books", boundary);

Console::WriteLine("Position (after boundary): {0}", navigator->Name);
Console::WriteLine(navigator->OuterXml);

navigator->MoveToFollowing("title", "http://www.contoso.com/books", boundary);

Console::WriteLine("Position (before boundary): {0}", navigator->Name);
Console::WriteLine(navigator->OuterXml);
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToFollowing("book", "http://www.contoso.com/books");
XPathNavigator boundary = navigator.Clone();
boundary.MoveToFollowing("first-name", "http://www.contoso.com/books");

navigator.MoveToFollowing("price", "http://www.contoso.com/books", boundary);

Console.WriteLine("Position (after boundary): {0}", navigator.Name);
Console.WriteLine(navigator.OuterXml);

navigator.MoveToFollowing("title", "http://www.contoso.com/books", boundary);

Console.WriteLine("Position (before boundary): {0}", navigator.Name);
Console.WriteLine(navigator.OuterXml);
Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToFollowing("book", "http://www.contoso.com/books")
Dim boundary As XPathNavigator = navigator.Clone()
boundary.MoveToFollowing("first-name", "http://www.contoso.com/books")

navigator.MoveToFollowing("price", "http://www.contoso.com/books", boundary)

Console.WriteLine("Position (after boundary): {0}", navigator.Name)
Console.WriteLine(navigator.OuterXml)

navigator.MoveToFollowing("title", "http://www.contoso.com/books", boundary)

Console.WriteLine("Position (before boundary): {0}", navigator.Name)
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

  • Si el XPathNavigator límite pasado como parámetro no se coloca después de la posición del actual XPathNavigator , se omite.

  • Si el XPathNavigator parámetro de límite es null, el siguiente elemento con el nombre local y el URI del espacio de nombres especificado se encuentra en orden de documento.

  • Los MoveToFollowing métodos no se pueden usar para moverse a nodos de atributo o espacio de nombres. Si el XPathNavigator límite pasado como parámetro se coloca sobre un nodo de atributo o espacio de nombres, es equivalente al XPathNavigator parámetro de límite que se ha colocado en el primer nodo secundario de su elemento primario. Esto garantiza que este método pueda coincidir con el elemento primario del nodo de atributo o espacio de nombres en el que se coloca el XPathNavigator parámetro de límite.

  • Si el MoveToFollowing método devuelve false, la posición de no XPathNavigator cambia.

Se aplica a

MoveToFollowing(XPathNodeType)

Mueve el XPathNavigator al elemento siguiente del XPathNodeType especificado en el orden del documento.

public:
 virtual bool MoveToFollowing(System::Xml::XPath::XPathNodeType type);
public virtual bool MoveToFollowing (System.Xml.XPath.XPathNodeType type);
abstract member MoveToFollowing : System.Xml.XPath.XPathNodeType -> bool
override this.MoveToFollowing : System.Xml.XPath.XPathNodeType -> bool
Public Overridable Function MoveToFollowing (type As XPathNodeType) As Boolean

Parámetros

type
XPathNodeType

XPathNodeType del elemento. XPathNodeType no puede ser Attribute ni Namespace.

Devoluciones

Boolean

true, si el elemento XPathNavigator se desplaza correctamente; de lo contrario, false.

Ejemplos

En el ejemplo siguiente, XPathNavigator se mueve de la raíz del contosoBooks.xml archivo al elemento siguiente bookstore .

    XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
    XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToFollowing(XPathNodeType::Element);

    Console::WriteLine("Position: {0}", navigator->Name);
    Console::WriteLine(navigator->OuterXml);
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToFollowing(XPathNodeType.Element);

Console.WriteLine("Position: {0}", navigator.Name);
Console.WriteLine(navigator.OuterXml);
Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToFollowing(XPathNodeType.Element)

Console.WriteLine("Position: {0}", navigator.Name)
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

Se aplica a

MoveToFollowing(String, String)

Mueve el XPathNavigator al elemento con el nombre local y el URI de espacio de nombres especificados en el orden del documento.

public:
 virtual bool MoveToFollowing(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool MoveToFollowing (string localName, string namespaceURI);
abstract member MoveToFollowing : string * string -> bool
override this.MoveToFollowing : string * string -> bool
Public Overridable Function MoveToFollowing (localName As String, namespaceURI As String) As Boolean

Parámetros

localName
String

Nombre local del elemento.

namespaceURI
String

Identificador URI de espacio de nombres del elemento.

Devoluciones

Boolean

true, si el elemento XPathNavigator se desplaza correctamente; de lo contrario, false.

Ejemplos

En el ejemplo siguiente, XPathNavigator se mueve de la raíz del contosoBooks.xml archivo al primer price elemento.

XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

navigator->MoveToFollowing("price", "http://www.contoso.com/books");

Console::WriteLine("Position: {0}", navigator->Name);
Console::WriteLine(navigator->OuterXml);
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToFollowing("price", "http://www.contoso.com/books");

Console.WriteLine("Position: {0}", navigator.Name);
Console.WriteLine(navigator.OuterXml);
Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToFollowing("price", "http://www.contoso.com/books")

Console.WriteLine("Position: {0}", navigator.Name)
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

Si el MoveToFollowing método devuelve false, la posición de no XPathNavigator cambia.

Se aplica a