XPathNavigator.MoveToFollowing Método

Definição

Espaço de Nomes:
System.Xml.XPath
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.XPath.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Move o XPathNavigator para o elemento especificado na ordem do documento.

Sobrecargas

Name Description
MoveToFollowing(XPathNodeType, XPathNavigator)

Move o XPathNavigator para o seguinte elemento do XPathNodeType especificado, para o limite especificado, por ordem do documento.
MoveToFollowing(String, String, XPathNavigator)

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados, para a fronteira especificada, por ordem do documento.
MoveToFollowing(XPathNodeType)

Move o XPathNavigator para o elemento seguinte do XPathNodeType especificado na ordem do documento.
MoveToFollowing(String, String)

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados na ordem do documento.

MoveToFollowing(XPathNodeType, XPathNavigator)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Move o XPathNavigator para o seguinte elemento do XPathNodeType especificado, para o limite especificado, por ordem do 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

O XPathNodeType do elemento. O XPathNodeType não pode ser Attribute ou Namespace.

end
XPathNavigator

O XPathNavigator objeto posicionado na fronteira do elemento pelo qual a corrente XPathNavigator não irá passar enquanto procura o elemento seguinte.

Devoluções

Boolean

true se se XPathNavigator moveram com sucesso; caso contrário, false.

Exemplos

No exemplo seguinte, o XPathNavigator é movido da raiz do contosoBooks.xml ficheiro para o elemento seguinte price . Um clone do XPathNavigator objeto é feito usando o Clone método. O clonado XPathNavigator, posicionado no price elemento, será usado como fronteira. Alterações na posição do clonado XPathNavigator não afetam o original XPathNavigator. O original XPathNavigator é movido de volta para a raiz do contosoBooks.xml ficheiro usando o MoveToRoot método. O título e o nome e apelido do autor são recuperados usando o MoveToFollowing método e um XPathNodeType de Text. O MoveToFollowing método devolverá true até que a price fronteira do elemento seja atingida.

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

O exemplo usa o contosoBooks.xml arquivo como uma 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>

Observações

  • O MoveToFollowing método não se move para nós de atributos ou namespace. Se o valor do XPathNodeType parâmetro for Attribute ou Namespace, o MoveToFollowing método devolve false e a posição do XPathNavigator permanece inalterada.

  • Se a XPathNavigator fronteira passada como parâmetro não estiver posicionada após a posição da corrente XPathNavigator , é ignorada.

  • Se XPathNavigator a fronteira passada como parâmetro for null o nó seguinte com o especificado XPathNodeType está localizado na ordem do documento.

  • Os MoveToFollowing métodos não podem ser usados para mover para nós de atributos ou namespace. Se a XPathNavigator fronteira passada como parâmetro estiver posicionada sobre um nó de atributo ou espaço de nomes, é equivalente a o XPathNavigator parâmetro de fronteira ter sido posicionado no primeiro nó filho do seu elemento pai. Isto garante que o elemento pai do nó do atributo ou do espaço de nomes onde o XPathNavigator parâmetro de fronteira está posicionado pode ser correspondido por este método.

  • Se o MoveToFollowing método devolver false, a posição do XPathNavigator permanece inalterada.

Aplica-se a

MoveToFollowing(String, String, XPathNavigator)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados, para a fronteira especificada, por ordem do 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

O nome local do elemento.

namespaceURI
String

O URI do namespace do elemento.

end
XPathNavigator

O XPathNavigator objeto posicionado na fronteira do elemento pelo qual a corrente XPathNavigator não irá passar enquanto procura o elemento seguinte.

Devoluções

Boolean

true se se XPathNavigator moveram com sucesso; caso contrário, false.

Exemplos

No exemplo seguinte, o XPathNavigator é movido da raiz do contosoBooks.xml ficheiro para o elemento seguinte book . Um clone do XPathNavigator objeto é feito usando o Clone método e é movido do book elemento para o seguinte first-name . O clonado XPathNavigator, posicionado no first-name elemento, será usado como fronteira. Alterações na posição do clonado XPathNavigator não afetam o original XPathNavigator. O original XPathNavigator tenta então mover-se para o elemento seguinte price usando o MoveToFollowing método com a fronteira passada como parâmetro. Esta jogada falha porque o elemento seguinte price está fora do limite. O original XPathNavigator tenta então mover-se para o elemento title seguinte, que está antes da fronteira, usando o mesmo método e consegue.

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)

O exemplo usa o contosoBooks.xml arquivo como uma 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>

Observações

  • Se a XPathNavigator fronteira passada como parâmetro não estiver posicionada após a posição da corrente XPathNavigator , é ignorada.

  • Se o XPathNavigator parâmetro de fronteira for null, o elemento seguinte com o nome local e o URI do espaço de nomes especificados está localizado por ordem do documento.

  • Os MoveToFollowing métodos não podem ser usados para mover para nós de atributos ou namespace. Se a XPathNavigator fronteira passada como parâmetro estiver posicionada sobre um nó de atributo ou espaço de nomes, é equivalente a o XPathNavigator parâmetro de fronteira ter sido posicionado no primeiro nó filho do seu elemento pai. Isto garante que o elemento pai do nó do atributo ou do espaço de nomes onde o XPathNavigator parâmetro de fronteira está posicionado pode ser correspondido por este método.

  • Se o MoveToFollowing método devolver false, a posição do XPathNavigator permanece inalterada.

Aplica-se a

MoveToFollowing(XPathNodeType)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Move o XPathNavigator para o elemento seguinte do XPathNodeType especificado na ordem do 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

O XPathNodeType do elemento. O XPathNodeType não pode ser Attribute ou Namespace.

Devoluções

Boolean

true se se XPathNavigator moveram com sucesso; caso contrário, false.

Exemplos

No exemplo seguinte, o XPathNavigator é movido da raiz do contosoBooks.xml ficheiro para o elemento seguinte bookstore .

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)

O exemplo usa o contosoBooks.xml arquivo como uma 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>

Observações

Aplica-se a

MoveToFollowing(String, String)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Move o XPathNavigator para o elemento com o nome local e o URI do espaço de nomes especificados na ordem do 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

O nome local do elemento.

namespaceURI
String

O URI do namespace do elemento.

Devoluções

Boolean

true se se XPathNavigator moveram com sucesso; caso contrário, false.

Exemplos

No exemplo seguinte, o XPathNavigator é movido da raiz do contosoBooks.xml ficheiro para o primeiro price elemento.

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)

O exemplo usa o contosoBooks.xml arquivo como uma 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>

Observações

Se o MoveToFollowing método devolver false, a posição do XPathNavigator permanece inalterada.

Aplica-se a