XPathNavigator.Select Método

Referência

Definição

Namespace:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Seleciona um nó definido usando a expressão XPath especificada.

Sobrecargas

Select(String)	Seleciona um nó definido usando a expressão XPath especificada.
Select(XPathExpression)	Seleciona um nó definido usando o XPathExpression especificado.
Select(String, IXmlNamespaceResolver)	Seleciona um nó definido usando a expressão XPath especificada com o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace.

Select(String)

Seleciona um nó definido usando a expressão XPath especificada.

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

Parâmetros

xpath: String

Um String que representa uma expressão XPath.

Retornos

XPathNodeIterator

Um XPathNodeIterator que aponta para o conjunto de nós selecionado.

Exceções

ArgumentException

A expressão XPath contém um erro ou seu tipo de retorno não é um conjunto de nós.

XPathException

A expressão XPath não é válida.

Exemplos

O exemplo a seguir usa o Select método para selecionar um conjunto de nós.

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

O exemplo usa o arquivo books.xml como entrada.

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

Comentários

O contexto para a seleção é a posição do momento em que XPathNavigator esse método é chamado. Depois de chamar esse método, o XPathNodeIterator retornado representa o conjunto de nós selecionados. Use MoveNext o XPathNodeIterator método do para iterar sobre o conjunto de nós selecionado.

O código C# a seguir itera sobre o conjunto de nós selecionado.

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

Veja a seguir notas importantes a serem consideradas ao usar o Select método.

Você ainda pode usar qualquer um dos XPathNavigator métodos de navegação do objeto para se mover dentro do XPathNavigator. Os XPathNavigator métodos de navegação são independentes dos nós selecionados no XPathNodeIterator.
Chamadas futuras para o Select método retornam um novo XPathNodeIterator objeto que aponta para o conjunto selecionado de nós que corresponde à nova Select chamada. Os dois XPathNodeIterator objetos são completamente independentes um do outro.
Se a expressão XPath exigir resolução de namespace, use a Select sobrecarga, que usa um XPathExpression argumento como seu.
Esse método não tem nenhum efeito sobre o estado do XPathNavigator.

Confira também

Aplica-se a

Select(XPathExpression)

Seleciona um nó definido usando o XPathExpression especificado.

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

Parâmetros

expr: XPathExpression

Um objeto XPathExpression que contém a consulta XPath compilada.

Retornos

XPathNodeIterator

Um XPathNodeIterator que aponta para o conjunto de nó selecionado.

Exceções

ArgumentException

A expressão XPath contém um erro ou seu tipo de retorno não é um conjunto de nós.

XPathException

A expressão XPath não é válida.

Exemplos

O exemplo a seguir usa o Select método para selecionar um conjunto de nós.

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

O exemplo usa o arquivo books.xml como entrada.

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

Comentários

O contexto para a seleção é a posição do XPathNavigator quando você chamou esse método. Depois de chamar esse método, o XPathNodeIterator retornado representa o conjunto de nós selecionados. Use MoveNext para XPathNodeIterator iterar sobre o conjunto de nós selecionado.

O código C# a seguir itera sobre o conjunto de nós selecionado.

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

Veja a seguir notas importantes a serem consideradas ao usar o Select método.

Você ainda pode usar qualquer um dos XPathNavigator métodos de navegação do objeto para se mover dentro do XPathNavigator. Os XPathNavigator métodos de navegação são independentes dos nós selecionados no XPathNodeIterator.
Chamadas futuras para o Select método retornam um novo XPathNodeIterator objeto que aponta para o conjunto selecionado de nós que corresponde à nova Select chamada. Os dois XPathNodeIterator objetos são completamente independentes um do outro.
Se a XPathExpression resolução de namespace exigir, o par de URI de prefixo e namespace deverá ser adicionado a um XmlNamespaceManager, e o SetContext método deverá ser chamado para especificar o XmlNamespaceManager uso para resolução de namespace.

Por exemplo, suponha que o documento contenha os seguintes nós XML.

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

Nesse caso, o código C# a seguir seleciona o bk:ISBN nó.

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);

Observação

Se não XPathExpression incluir um prefixo, supõe-se que o URI do namespace seja o namespace vazio. Se o XML incluir um namespace padrão, você ainda deverá usar o SetContext método e fornecer um XmlNamespaceManager que contenha um URI de prefixo e namespace para manipular o namespace padrão.

Por exemplo, suponha que você tenha o XML a seguir.

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

Nesse caso, o seguinte código C# seleciona todos os nós do livro:

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);

Esse método não tem nenhum efeito sobre o estado do XPathNavigator.

Confira também

Aplica-se a

Select(String, IXmlNamespaceResolver)

Seleciona um nó definido usando a expressão XPath especificada com o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace.

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

Parâmetros

xpath: String

Um String que representa uma expressão XPath.

resolver: IXmlNamespaceResolver

O objeto IXmlNamespaceResolver usado para resolver prefixos de namespace.

Retornos

XPathNodeIterator

Um XPathNodeIterator que aponta para o conjunto de nó selecionado.

Exceções

ArgumentException

A expressão XPath contém um erro ou seu tipo de retorno não é um conjunto de nós.

XPathException

A expressão XPath não é válida.

Exemplos

O exemplo a seguir ilustra a seleção de um conjunto de nós usando o Select método com o XmlNamespaceManager objeto especificado para resolver prefixos de namespace na expressão 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

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

Aplica-se a

XPathNavigator.Select Método

Definição

Sobrecargas

Select(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Select(XPathExpression)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Select(String, IXmlNamespaceResolver)

Parâmetros

Retornos

Exceções

Exemplos

Aplica-se a

Recursos adicionais