XPathNavigator.MoveToFollowing Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přesune XPathNavigator zadaný prvek v pořadí dokumentu.
Přetížení
MoveToFollowing(XPathNodeType, XPathNavigator) |
XPathNavigator Přesune následující prvek zadaného XPathNodeType prvku na hranici určenou v pořadí dokumentu. |
MoveToFollowing(String, String, XPathNavigator) |
XPathNavigator Přesune objekt do elementu se zadaným místním názvem a identifikátorem URI oboru názvů do zadané hranice v pořadí dokumentu. |
MoveToFollowing(XPathNodeType) |
XPathNavigator Přesune následující prvek XPathNodeType zadaného v pořadí dokumentu. |
MoveToFollowing(String, String) |
XPathNavigator Přesune objekt do elementu s místním názvem a identifikátorem URI oboru názvů zadaným v pořadí dokumentu. |
MoveToFollowing(XPathNodeType, XPathNavigator)
XPathNavigator Přesune následující prvek zadaného XPathNodeType prvku na hranici určenou v pořadí dokumentu.
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
Parametry
- type
- XPathNodeType
Prvek XPathNodeType . Nesmí XPathNodeType být Attribute nebo Namespace.
- end
- XPathNavigator
Objekt XPathNavigator umístěný na hranici prvku, který aktuální XPathNavigator nebude přesouvat po minulosti při hledání následujícího prvku.
Návraty
true
pokud byla přesunuta XPathNavigator úspěšně; false
jinak .
Příklady
V následujícím příkladu XPathNavigator se přesune z kořenového contosoBooks.xml
adresáře souboru na následující price
prvek. Klon objektu XPathNavigator se provádí pomocí Clone metody. Klonovaný XPathNavigator, umístěný na price
prvku, se použije jako hranice. Změny v pozici klonovaného XPathNavigator souboru nemají vliv na původní XPathNavigator. Původní XPathNavigator soubor se pomocí metody přesune zpět do kořenového contosoBooks.xml
adresáře souboru MoveToRoot . Název a křestní jméno a příjmení autora se načte pomocí MoveToFollowing metody a XPathNodeType z Text. Metoda MoveToFollowing vrátí hodnotu true, dokud price
se nedosáhne hranice prvku.
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
Příklad přebírá contosoBooks.xml
soubor jako vstup.
<?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>
Poznámky
Metoda MoveToFollowing se nepřesune na uzly atributu nebo oboru názvů. Pokud je Attribute hodnota parametru XPathNodeType nebo Namespace, MoveToFollowing metoda vrátí
false
a pozice XPathNavigator je nezměněna.XPathNavigator Pokud hranice předaná jako parametr není umístěna za pozicí aktuálního XPathNavigator parametru, bude ignorována.
Pokud XPathNavigator hranice předaná jako parametr je
null
další následující uzel se zadaným XPathNodeType umístěním v pořadí dokumentu.Metody MoveToFollowing nelze použít k přechodu na uzly atributu nebo oboru názvů. XPathNavigator Pokud je hranice předaná jako parametr umístěna nad atributem nebo uzlem oboru názvů, je ekvivalentem XPathNavigator parametru hranice, který byl umístěn na prvním podřízeném uzlu nadřazeného prvku. Tím zajistíte, že nadřazený prvek atributu nebo uzlu oboru názvů, na který XPathNavigator je parametr hranice umístěn, lze shodovat touto metodou.
MoveToFollowing Pokud metoda vrátí
false
, pozice je XPathNavigator nezměněna.
Platí pro
MoveToFollowing(String, String, XPathNavigator)
XPathNavigator Přesune objekt do elementu se zadaným místním názvem a identifikátorem URI oboru názvů do zadané hranice v pořadí dokumentu.
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
Parametry
- localName
- String
Místní název elementu.
- namespaceURI
- String
Identifikátor URI oboru názvů elementu.
- end
- XPathNavigator
Objekt XPathNavigator umístěný na hranici prvku, který aktuální XPathNavigator nebude přesouvat po minulosti při hledání následujícího prvku.
Návraty
true
pokud byla přesunuta XPathNavigator úspěšně; false
jinak .
Příklady
V následujícím příkladu XPathNavigator se přesune z kořenového contosoBooks.xml
adresáře souboru na následující book
prvek. Klon objektu XPathNavigator se provádí pomocí Clone metody a je přesunut z elementu book
do následujícího first-name
elementu. Klonovaný XPathNavigator, umístěný na first-name
prvku, se použije jako hranice. Změny v pozici klonovaného XPathNavigator souboru nemají vliv na původní XPathNavigator. Původní XPathNavigator se pak pokusí přesunout na následující price
prvek pomocí MoveToFollowing metody s hranicí předanou jako parametr. Tento přesun selže, protože následující price
prvek je nad hranicí. Původní XPathNavigator se pak pokusí přesunout na následující title
prvek, který je před hranicí pomocí stejné metody a úspěšně.
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)
Příklad přebírá contosoBooks.xml
soubor jako vstup.
<?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>
Poznámky
XPathNavigator Pokud hranice předaná jako parametr není umístěna za pozicí aktuálního XPathNavigator parametru, bude ignorována.
XPathNavigator Pokud je
null
parametr hranice , následující prvek s místním názvem a zadaným identifikátorem URI oboru názvů je umístěn v pořadí dokumentu.Metody MoveToFollowing nelze použít k přechodu na uzly atributu nebo oboru názvů. XPathNavigator Pokud je hranice předaná jako parametr umístěna nad atributem nebo uzlem oboru názvů, je ekvivalentem XPathNavigator parametru hranice, který byl umístěn na prvním podřízeném uzlu nadřazeného prvku. Tím zajistíte, že nadřazený prvek atributu nebo uzlu oboru názvů, na který XPathNavigator je parametr hranice umístěn, lze shodovat touto metodou.
MoveToFollowing Pokud metoda vrátí
false
, pozice je XPathNavigator nezměněna.
Platí pro
MoveToFollowing(XPathNodeType)
XPathNavigator Přesune následující prvek XPathNodeType zadaného v pořadí dokumentu.
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
Parametry
- type
- XPathNodeType
Prvek XPathNodeType . Nesmí XPathNodeType být Attribute nebo Namespace.
Návraty
true
pokud byla přesunuta XPathNavigator úspěšně; false
jinak .
Příklady
V následujícím příkladu XPathNavigator se přesune z kořenového contosoBooks.xml
adresáře souboru na následující bookstore
prvek.
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)
Příklad přebírá contosoBooks.xml
soubor jako vstup.
<?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>
Poznámky
Metoda MoveToFollowing se nepřesune na uzly atributu nebo oboru názvů. Pokud je Attribute hodnota parametru XPathNodeType nebo Namespace, MoveToFollowing metoda vrátí
false
a pozice XPathNavigator je nezměněna.MoveToFollowing Pokud metoda vrátí
false
, pozice je XPathNavigator nezměněna.
Platí pro
MoveToFollowing(String, String)
XPathNavigator Přesune objekt do elementu s místním názvem a identifikátorem URI oboru názvů zadaným v pořadí dokumentu.
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
Parametry
- localName
- String
Místní název elementu.
- namespaceURI
- String
Identifikátor URI oboru názvů elementu.
Návraty
true
pokud byla přesunuta XPathNavigator úspěšně; false
jinak .
Příklady
V následujícím příkladu XPathNavigator se přesune z kořenového contosoBooks.xml
adresáře souboru na první price
prvek.
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)
Příklad přebírá contosoBooks.xml
soubor jako vstup.
<?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>
Poznámky
MoveToFollowing Pokud metoda vrátí false
, pozice je XPathNavigator nezměněna.