Partage via


XPathNavigator.MoveToFollowing Méthode

Définition

Déplace l'objet XPathNavigator vers l'élément spécifié dans l'ordre du document.

Surcharges

MoveToFollowing(XPathNodeType, XPathNavigator)

Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié, à la limite spécifiée, dans l'ordre du document.

MoveToFollowing(String, String, XPathNavigator)

Déplace le XPathNavigator vers l'élément avec le nom local et l'URI d'espace de noms spécifiés, à la limite spécifiée, dans l'ordre du document.

MoveToFollowing(XPathNodeType)

Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié dans l'ordre du document.

MoveToFollowing(String, String)

Déplace le XPathNavigator vers l'élément dont le nom local et l'URI d'espace de noms sont spécifiés dans l'ordre du document.

MoveToFollowing(XPathNodeType, XPathNavigator)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié, à la limite spécifiée, dans l'ordre du document.

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

Paramètres

type
XPathNodeType

XPathNodeType de l’élément. XPathNodeType ne peut pas être Attribute ou Namespace.

end
XPathNavigator

Objet XPathNavigator positionné sur la limite de l’élément que le XPathNavigator actuel ne dépassera pas en recherchant l’élément suivant.

Retours

true si le déplacement de XPathNavigator est réussi ; sinon, false.

Exemples

Dans l’exemple suivant, le XPathNavigator est déplacé de la racine du contosoBooks.xml fichier vers l’élément suivant price . Un clone de l’objet est effectué à l’aide XPathNavigator de la Clone méthode . Le cloné XPathNavigator, positionné sur l’élément price , sera utilisé comme limite. Les modifications apportées à la position du cloné XPathNavigator n’affectent pas le fichier d’origine XPathNavigator. L’original XPathNavigator est déplacé à la racine du fichier à l’aide contosoBooks.xml de la MoveToRoot méthode . Le titre et le prénom et le nom de l’auteur sont récupérés à l’aide de la MoveToFollowing méthode et d’un XPathNodeType de Text. La MoveToFollowing méthode retourne true jusqu’à ce que la limite de l’élément price soit atteinte.

    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

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

  • La MoveToFollowing méthode ne se déplace pas vers des nœuds d’attribut ou d’espace de noms. Si la valeur du XPathNodeType paramètre est Attribute ou Namespace, la MoveToFollowing méthode retourne false et la position du XPathNavigator est inchangée.

  • Si la XPathNavigator limite passée en tant que paramètre n’est pas positionnée après la position du courant XPathNavigator , elle est ignorée.

  • Si XPathNavigator la limite passée en tant que paramètre est null le nœud suivant avec le spécifié XPathNodeType se trouve dans l’ordre du document.

  • Les MoveToFollowing méthodes ne peuvent pas être utilisées pour déplacer vers des nœuds d’attribut ou d’espace de noms. Si la XPathNavigator limite passée en tant que paramètre est positionnée sur un nœud d’attribut ou d’espace de noms, elle équivaut à ce que le XPathNavigator paramètre de limite ait été positionné sur le premier nœud enfant de son élément parent. Cela garantit que l’élément parent du nœud d’attribut ou d’espace de noms sur lequel le XPathNavigator paramètre de limite est positionné peut être mis en correspondance par cette méthode.

  • Si la MoveToFollowing méthode retourne false, la position du XPathNavigator est inchangée.

S’applique à

MoveToFollowing(String, String, XPathNavigator)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Déplace le XPathNavigator vers l'élément avec le nom local et l'URI d'espace de noms spécifiés, à la limite spécifiée, dans l'ordre du document.

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

Paramètres

localName
String

Le nom local de l'élément.

namespaceURI
String

L'URI de l'espace de noms de l'élément.

end
XPathNavigator

Objet XPathNavigator positionné sur la limite de l'élément que le XPathNavigator actuel ne dépassera pas en recherchant l'élément suivant.

Retours

true si le déplacement de XPathNavigator est réussi ; sinon, false.

Exemples

Dans l’exemple suivant, le XPathNavigator est déplacé de la racine du contosoBooks.xml fichier vers l’élément suivant book . Un clone de l’objet est effectué à l’aide XPathNavigator de la Clone méthode et est déplacé de l’élément book vers l’élément suivant first-name . Le cloné XPathNavigator, positionné sur l’élément first-name , sera utilisé comme limite. Les modifications apportées à la position du cloné XPathNavigator n’affectent pas le fichier d’origine XPathNavigator. L’original XPathNavigator tente ensuite de se déplacer vers l’élément suivant price à l’aide de la MoveToFollowing méthode avec la limite passée en tant que paramètre. Ce déplacement échoue, car l’élément suivant price est au-delà de la limite. L’original XPathNavigator tente ensuite de se déplacer vers l’élément suivant title qui se trouve avant la limite à l’aide de la même méthode et réussit.

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)

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

  • Si la XPathNavigator limite passée en tant que paramètre n’est pas positionnée après la position du courant XPathNavigator , elle est ignorée.

  • Si le XPathNavigator paramètre de limite est null, l’élément suivant avec le nom local et l’URI d’espace de noms spécifiés se trouve dans l’ordre du document.

  • Les MoveToFollowing méthodes ne peuvent pas être utilisées pour déplacer vers des nœuds d’attribut ou d’espace de noms. Si la XPathNavigator limite passée en tant que paramètre est positionnée sur un nœud d’attribut ou d’espace de noms, elle équivaut à ce que le XPathNavigator paramètre de limite ait été positionné sur le premier nœud enfant de son élément parent. Cela garantit que l’élément parent du nœud d’attribut ou d’espace de noms sur lequel le XPathNavigator paramètre de limite est positionné peut être mis en correspondance par cette méthode.

  • Si la MoveToFollowing méthode retourne false, la position du XPathNavigator est inchangée.

S’applique à

MoveToFollowing(XPathNodeType)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Déplace le XPathNavigator vers l'élément suivant du XPathNodeType spécifié dans l'ordre du document.

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

Paramètres

type
XPathNodeType

XPathNodeType de l’élément. XPathNodeType ne peut pas être Attribute ou Namespace.

Retours

true si le déplacement de XPathNavigator est réussi ; sinon, false.

Exemples

Dans l’exemple suivant, le XPathNavigator est déplacé de la racine du contosoBooks.xml fichier vers l’élément suivant 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)

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

S’applique à

MoveToFollowing(String, String)

Source:
XPathNavigator.cs
Source:
XPathNavigator.cs
Source:
XPathNavigator.cs

Déplace le XPathNavigator vers l'élément dont le nom local et l'URI d'espace de noms sont spécifiés dans l'ordre du document.

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

Paramètres

localName
String

Le nom local de l'élément.

namespaceURI
String

L'URI de l'espace de noms de l'élément.

Retours

true si le déplacement de XPathNavigator est réussi ; sinon, false.

Exemples

Dans l’exemple suivant, le XPathNavigator est déplacé de la racine du contosoBooks.xml fichier vers le premier price élément.

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)

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

Si la MoveToFollowing méthode retourne false, la position du XPathNavigator est inchangée.

S’applique à