XPathNavigator.MoveToFollowing 方法

參考

定義

命名空間:: System.Xml.XPath

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.XPath.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將 XPathNavigator 移至文件順序中指定的項目。

多載

MoveToFollowing(XPathNodeType, XPathNavigator)	會根據文件順序，將 XPathNavigator 移至下列指定界限之指定 XPathNodeType 的項目。
MoveToFollowing(String, String, XPathNavigator)	會根據文件順序，將 XPathNavigator 移到指定界限之區域名稱和指定命名空間 URI 的項目。
MoveToFollowing(XPathNodeType)	會根據文件順序，將 XPathNavigator 移至下列指定 XPathNodeType 的項目。
MoveToFollowing(String, String)	會根據文件順序，將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的項目。

MoveToFollowing(XPathNodeType, XPathNavigator)

會根據文件順序，將 XPathNavigator 移至下列指定界限之指定 XPathNodeType 的項目。

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

參數

type: XPathNodeType

項目的 XPathNodeType。 XPathNodeType 不能是 Attribute 或 Namespace。

end: XPathNavigator

目前的 XPathNavigator 在搜尋下列項目時不會超出的 XPathNavigator 物件所在項目界限。

傳回

Boolean

如果 XPathNavigator 成功移動，則為 true；否則為 false。

範例

在下列範例中，會將 XPathNavigator 從檔案的 contosoBooks.xml 根目錄移至下列 price 專案。物件的複製 XPathNavigator 品是使用 Clone 方法建立的。複製 XPathNavigator 的，位於元素上 price ，將會當做界限使用。複製 XPathNavigator 位置的變更不會影響原始 XPathNavigator 的。 XPathNavigator原始的會使用 MoveToRoot 方法移回檔案的 contosoBooks.xml 根目錄。使用方法和的，擷取 MoveToFollowing 作者的標題和 XPathNodeType Text 姓氏。方法 MoveToFollowing 會傳回 true， price 直到到達元素界限為止。

    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

範例將 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>

備註

方法 MoveToFollowing 不會移至屬性或命名空間節點。 XPathNodeType如果參數值為 Attribute 或 Namespace ，則 MoveToFollowing 方法會傳 false 回，且的位置 XPathNavigator 不會變更。
XPathNavigator如果傳遞為參數的界限不在目前 XPathNavigator 的位置之後，則會予以忽略。
如果 XPathNavigator 以參數方式傳遞的界限是 null 下一個具有指定 XPathNodeType 節點的下一個節點，則會依檔順序排列。
方法 MoveToFollowing 無法用來移至屬性或命名空間節點。如果傳遞為參數的 XPathNavigator 界限位於屬性或命名空間節點上，則 XPathNavigator 相當於其父元素的第一個子節點上已放置界限參數。這可確保界限參數所在的屬性或命名空間節點 XPathNavigator 父元素可由此方法比對。
如果方法傳 MoveToFollowing false 回，則的位置不會 XPathNavigator 變更。

適用於

MoveToFollowing(String, String, XPathNavigator)

會根據文件順序，將 XPathNavigator 移到指定界限之區域名稱和指定命名空間 URI 的項目。

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

參數

localName: String

項目的本機名稱。

namespaceURI: String

項目的命名空間 URI。

end: XPathNavigator

XPathNavigator 物件所在的項目界限，目前的 XPathNavigator 在搜尋下列項目時，將不會超出這個界限。

傳回

Boolean

如果 XPathNavigator 成功移動，則為 true；否則為 false。

範例

在下列範例中，會將 XPathNavigator 從檔案的 contosoBooks.xml 根目錄移至下列 book 專案。物件的複製 XPathNavigator 是使用 Clone 方法建立，而且會從 book 專案移至下列 first-name 專案。複製 XPathNavigator 的，位於元素上 first-name ，將會當做界限使用。複製 XPathNavigator 位置的變更不會影響原始 XPathNavigator 的。然後，原始 XPathNavigator 的會嘗試使用方法移動至下列 price 專案， MoveToFollowing 並將界限傳遞為參數。此移動失敗，因為下列 price 元素超出界限。然後，原始 XPathNavigator 會嘗試移至下列 title 元素，也就是使用相同方法的界限之前，且成功。

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)

範例將 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>

備註

XPathNavigator如果傳遞為參數的界限不在目前 XPathNavigator 的位置之後，則會予以忽略。
XPathNavigator如果界限參數為 null ，則下列具有指定之本機名稱和命名空間 URI 的專案會依檔順序排列。
方法 MoveToFollowing 無法用來移至屬性或命名空間節點。如果傳遞為參數的 XPathNavigator 界限位於屬性或命名空間節點上，則 XPathNavigator 相當於其父元素的第一個子節點上已放置界限參數。這可確保界限參數所在的屬性或命名空間節點 XPathNavigator 父元素可由此方法比對。
如果方法傳 MoveToFollowing false 回，則的位置不會 XPathNavigator 變更。

適用於

MoveToFollowing(XPathNodeType)

會根據文件順序，將 XPathNavigator 移至下列指定 XPathNodeType 的項目。

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

參數

type: XPathNodeType

項目的 XPathNodeType。 XPathNodeType 不能是 Attribute 或 Namespace。

傳回

Boolean

如果 XPathNavigator 成功移動，則為 true；否則為 false。

範例

在下列範例中，會將 XPathNavigator 從檔案的 contosoBooks.xml 根目錄移至下列 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)

範例將 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>

備註

方法 MoveToFollowing 不會移至屬性或命名空間節點。 XPathNodeType如果參數值為 Attribute 或 Namespace ，則 MoveToFollowing 方法會傳 false 回，且的位置 XPathNavigator 不會變更。
如果方法傳 MoveToFollowing false 回，則的位置不會 XPathNavigator 變更。

適用於

MoveToFollowing(String, String)

會根據文件順序，將 XPathNavigator 移到具有指定區域名稱和命名空間 URI 的項目。

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

參數

localName: String

項目的本機名稱。

namespaceURI: String

項目的命名空間 URI。

傳回

Boolean

如果 XPathNavigator 成功移動，則為 true；否則為 false。

範例

在下列範例中，會將 XPathNavigator 從檔案的 contosoBooks.xml 根目錄移至第一個專案 price 。

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)

範例將 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>

備註

如果方法傳 MoveToFollowing false 回，則的位置不會 XPathNavigator 變更。

適用於

XPathNavigator.MoveToFollowing 方法

定義

多載

MoveToFollowing(XPathNodeType, XPathNavigator)

參數

傳回

範例

備註

適用於

MoveToFollowing(String, String, XPathNavigator)

參數

傳回

範例

備註

適用於

MoveToFollowing(XPathNodeType)

參數

傳回

範例

備註

適用於

MoveToFollowing(String, String)

參數

傳回

範例

備註

適用於

其他資源