XPathNavigator.Select Metoda

Reference

Definice

Obor názvů:: System.Xml.XPath

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XPath.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

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í.

Vybere sadu uzlů pomocí zadaného výrazu XPath.

Přetížení

Select(String)	Vybere sadu uzlů pomocí zadaného výrazu XPath.
Select(XPathExpression)	Vybere sadu uzlů pomocí zadaného souboru XPathExpression.
Select(String, IXmlNamespaceResolver)	Vybere sadu uzlů pomocí zadaného výrazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů.

Select(String)

Vybere sadu uzlů pomocí zadaného výrazu XPath.

public:
 virtual System::Xml::XPath::XPathNodeIterator ^ Select(System::String ^ xpath);

public virtual System.Xml.XPath.XPathNodeIterator Select (string xpath);

abstract member Select : string -> System.Xml.XPath.XPathNodeIterator
override this.Select : string -> System.Xml.XPath.XPathNodeIterator

Public Overridable Function Select (xpath As String) As XPathNodeIterator

Parametry

xpath: String

A String představující výraz XPath.

Návraty

XPathNodeIterator

Odkazování XPathNodeIterator na vybranou sadu uzlů

Výjimky

ArgumentException

Výraz XPath obsahuje chybu nebo jeho návratový typ není sada uzlů.

XPathException

Výraz XPath není platný.

Příklady

Následující příklad používá metodu Select k výběru sady uzlů.

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

XPathNodeIterator^ nodes = navigator->Select("/bookstore/book");
nodes->MoveNext();
XPathNavigator^ nodesNavigator = nodes->Current;

XPathNodeIterator^ nodesText = nodesNavigator->SelectDescendants(XPathNodeType::Text, false);

while (nodesText->MoveNext())
    Console::WriteLine(nodesText->Current->Value);

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

XPathNodeIterator nodes = navigator.Select("/bookstore/book");
nodes.MoveNext();
XPathNavigator nodesNavigator = nodes.Current;

XPathNodeIterator nodesText = nodesNavigator.SelectDescendants(XPathNodeType.Text, false);

while (nodesText.MoveNext())
    Console.WriteLine(nodesText.Current.Value);

Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim nodes As XPathNodeIterator = navigator.Select("/bookstore/book")
nodes.MoveNext()
Dim nodesNavigator As XPathNavigator = nodes.Current

Dim nodesText As XPathNodeIterator = nodesNavigator.SelectDescendants(XPathNodeType.Text, False)

While nodesText.MoveNext()
    Console.WriteLine(nodesText.Current.Value)
End While

Příklad vezme books.xml soubor jako vstup.

<?xml version="1.0" encoding="utf-8" ?>   
<bookstore>  
    <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

Kontext výběru je pozice XPathNavigator volání této metody. Po volání této metody XPathNodeIterator představuje vrácená sada vybraných uzlů. Použijte MoveNext metodu XPathNodeIterator iterace vybrané sady uzlů.

Následující kód jazyka C# iteruje přes vybranou sadu uzlů.

XPathNodeIterator iterator = nav.Select("/bookstore/book");  
while (iterator.MoveNext())  
{  
    Console.WriteLine(Iterator.Current.Name);  
}

Při používání Select metody je potřeba vzít v úvahu následující důležité poznámky.

K pohybu v rámci objektu XPathNavigator můžete stále použít některou z metod navigace objektu XPathNavigator. Navigační XPathNavigator metody jsou nezávislé na vybraných uzlech v objektu XPathNodeIterator.
Budoucí volání metody Select vrátí nový XPathNodeIterator objekt, který odkazuje na vybranou sadu uzlů, které odpovídají novému Select volání. Tyto dva XPathNodeIterator objekty jsou zcela nezávislé na sobě.
Pokud výraz XPath vyžaduje překlad oboru názvů, použijte Select přetížení, které přebírá XPathExpression jako argument.
Tato metoda nemá žádný vliv na stav XPathNavigator.

Viz také

Platí pro

Select(XPathExpression)

Vybere sadu uzlů pomocí zadaného souboru XPathExpression.

public:
 virtual System::Xml::XPath::XPathNodeIterator ^ Select(System::Xml::XPath::XPathExpression ^ expr);

public virtual System.Xml.XPath.XPathNodeIterator Select (System.Xml.XPath.XPathExpression expr);

abstract member Select : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNodeIterator
override this.Select : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNodeIterator

Public Overridable Function Select (expr As XPathExpression) As XPathNodeIterator

Parametry

expr: XPathExpression

Objekt XPathExpression obsahující kompilovaný dotaz XPath.

Návraty

XPathNodeIterator

Odkazující XPathNodeIterator na vybranou sadu uzlů

Výjimky

ArgumentException

Výraz XPath obsahuje chybu nebo jeho návratový typ není sada uzlů.

XPathException

Výraz XPath není platný.

Příklady

Následující příklad používá metodu Select k výběru sady uzlů.

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

XPathExpression^ query = navigator->Compile("/bookstore/book");
XPathNodeIterator^ nodes = navigator->Select(query);
XPathNavigator^ nodesNavigator = nodes->Current;

XPathNodeIterator^ nodesText = nodesNavigator->SelectDescendants(XPathNodeType::Text, false);

while (nodesText->MoveNext())
{
    Console::WriteLine(nodesText->Current->Value);
}

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

XPathExpression query = navigator.Compile("/bookstore/book");
XPathNodeIterator nodes = navigator.Select(query);
XPathNavigator nodesNavigator = nodes.Current;

XPathNodeIterator nodesText = nodesNavigator.SelectDescendants(XPathNodeType.Text, false);

while (nodesText.MoveNext())
{
    Console.WriteLine(nodesText.Current.Value);
}

Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim query As XPathExpression = navigator.Compile("/bookstore/book")
Dim nodes As XPathNodeIterator = navigator.Select(query)
Dim nodesNavigator As XPathNavigator = nodes.Current

Dim nodesText As XPathNodeIterator = nodesNavigator.SelectDescendants(XPathNodeType.Text, False)

While nodesText.MoveNext()
    Console.WriteLine(nodesText.Current.Value)
End While

Příklad vezme books.xml soubor jako vstup.

<?xml version="1.0" encoding="utf-8" ?>   
<bookstore>  
    <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

Kontext výběru je pozice při XPathNavigator volání této metody. Po volání této metody XPathNodeIterator představuje vrácená sada vybraných uzlů. XPathNodeIterator Slouží MoveNext k iteraci nad vybranou sadou uzlů.

Následující kód jazyka C# iteruje přes vybranou sadu uzlů.

XPathNodeIterator ni = nav.Select(expr);  
while (ni.MoveNext())  
{  
    Console.WriteLine(ni.Current.Name);  
}

Při používání Select metody je potřeba vzít v úvahu následující důležité poznámky.

K pohybu v rámci objektu XPathNavigator můžete stále použít některou z metod navigace objektu XPathNavigator. Navigační XPathNavigator metody jsou nezávislé na vybraných uzlech v objektu XPathNodeIterator.
Budoucí volání metody Select vrátí nový XPathNodeIterator objekt, který odkazuje na vybranou sadu uzlů, které odpovídají novému Select volání. Tyto dva XPathNodeIterator objekty jsou zcela nezávislé na sobě.
XPathExpression Pokud vyžaduje rozlišení oboru názvů, musí se do objektu přidat XmlNamespaceManagerpár identifikátorů URI předpony a identifikátor URI oboru názvů a SetContext tato metoda musí být volána, aby se určila, která XmlNamespaceManager se má použít pro překlad oboru názvů.

Předpokládejme například, že dokument obsahuje následující uzly XML.

<bookstore xmlns:bk='urn:samples'>  
    <book bk:ISBN='1-325-0980'>  
        <title>Pride And Prejudice</title>  
    </book>  
</bookstore>

V takovém případě následující kód jazyka C# vybere bk:ISBN uzel.

XPathExpression expr = nav.Compile("book/@bk:ISBN");  
XmlNamespaceManager mngr = new XmlNamespaceManager(new NameTable());  
mngr.AddNamespace("bk","urn:samples");  
expr.SetContext(mngr);  
XPathNodeIterator ni = nav.Select(expr);

Poznámka

XPathExpression Pokud neobsahuje předponu, předpokládá se, že identifikátor URI oboru názvů je prázdný obor názvů. Pokud váš XML obsahuje výchozí obor názvů, musíte použít metodu SetContext a zadat XmlNamespaceManager , která obsahuje předponu a identifikátor URI oboru názvů pro zpracování výchozího oboru názvů.

Předpokládejme například, že máte následující XML.

<bookstore xmlns="http://www.lucernepublishing.com">  
    <book>  
        <title>Pride And Prejudice</title>  
    </book>  
</bookstore>

V tomto případě následující kód jazyka C# vybere všechny uzly knihy:

XmlNamespaceManager nsmgr = new XmlNamespaceManager(nav.NameTable);  
nsmgr.AddNamespace("ab", "http://www.lucernepublishing.com");  
XPathExpression expr;  
expr = nav.Compile("//ab:book");  
expr.SetContext(nsmgr);  
XPathNodeIterator ni = nav.Select(expr);

Tato metoda nemá žádný vliv na stav XPathNavigator.

Viz také

Platí pro

Select(String, IXmlNamespaceResolver)

Vybere sadu uzlů pomocí zadaného výrazu XPath s objektem IXmlNamespaceResolver určeným k překladu předpon oboru názvů.

public:
 virtual System::Xml::XPath::XPathNodeIterator ^ Select(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ resolver);

public virtual System.Xml.XPath.XPathNodeIterator Select (string xpath, System.Xml.IXmlNamespaceResolver? resolver);

public virtual System.Xml.XPath.XPathNodeIterator Select (string xpath, System.Xml.IXmlNamespaceResolver resolver);

abstract member Select : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNodeIterator
override this.Select : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNodeIterator

Public Overridable Function Select (xpath As String, resolver As IXmlNamespaceResolver) As XPathNodeIterator

Parametry

xpath: String

A String představující výraz XPath.

resolver: IXmlNamespaceResolver

Objekt IXmlNamespaceResolver použitý k překladu předpon oboru názvů.

Návraty

XPathNodeIterator

Odkazující XPathNodeIterator na vybranou sadu uzlů

Výjimky

ArgumentException

Výraz XPath obsahuje chybu nebo jeho návratový typ není sada uzlů.

XPathException

Výraz XPath není platný.

Příklady

Následující příklad znázorňuje výběr sady uzlů pomocí Select metody se XmlNamespaceManager zadaným objektem pro překlad předpon oboru názvů ve výrazu XPath.

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

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "http://www.contoso.com/books");

XPathNodeIterator^ nodes = navigator->Select("/bk:bookstore/bk:book/bk:price", manager);
// Move to the first node bk:price node.
if(nodes->MoveNext())
{
    // Now nodes.Current points to the first selected node.
XPathNavigator^ nodesNavigator = nodes->Current;

    // Select all the descendants of the current price node.
XPathNodeIterator^ nodesText = nodesNavigator->SelectDescendants(XPathNodeType::Text, false);

    while(nodesText->MoveNext())
    {
Console::WriteLine(nodesText->Current->Value);
    }
}

XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();
XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://www.contoso.com/books");

XPathNodeIterator nodes = navigator.Select("/bk:bookstore/bk:book/bk:price", manager);
// Move to the first node bk:price node
if(nodes.MoveNext())
{
    // now nodes.Current points to the first selected node
    XPathNavigator nodesNavigator = nodes.Current;

    //select all the descendants of the current price node
    XPathNodeIterator nodesText =
       nodesNavigator.SelectDescendants(XPathNodeType.Text, false);

    while(nodesText.MoveNext())
    {
       Console.WriteLine(nodesText.Current.Value);
    }
}

Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "http://www.contoso.com/books")

Dim nodes As XPathNodeIterator = navigator.Select("/bk:bookstore/bk:book/bk:price", manager)
' Move to the first node bk:price node.
If (nodes.MoveNext()) Then
    ' Now nodes.Current points to the first selected node.
    Dim nodesNavigator As XPathNavigator = nodes.Current

    ' Select all the descendants of the current price node.
    Dim nodesText As XPathNodeIterator = nodesNavigator.SelectDescendants(XPathNodeType.Text, False)

    While nodesText.MoveNext()
        Console.WriteLine(nodesText.Current.Value)
    End While
End If

Příklad vezme 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>

Platí pro

XPathNavigator.Select Metoda

Definice

Přetížení

Select(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Select(XPathExpression)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Select(String, IXmlNamespaceResolver)

Parametry

Návraty

Výjimky

Příklady

Platí pro

Další materiály