XPathNavigator.SelectSingleNode 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

Seleciona um único nó no XPathNavigator.

Sobrecargas

SelectSingleNode(String, IXmlNamespaceResolver)

Seleciona um único nó no objeto XPathNavigator usando a consulta XPath especificada com o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace.
SelectSingleNode(String)

Seleciona um único nó no XPathNavigator usando a consulta XPath especificada.
SelectSingleNode(XPathExpression)

Seleciona um único nó no XPathNavigator usando o objeto XPathExpression especificado.

SelectSingleNode(String, IXmlNamespaceResolver)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Seleciona um único nó no objeto XPathNavigator usando a consulta XPath especificada com o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ resolver);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (string xpath, System.Xml.IXmlNamespaceResolver? resolver);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath, System.Xml.IXmlNamespaceResolver resolver);
abstract member SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String, resolver As IXmlNamespaceResolver) As XPathNavigator

Parâmetros

xpath
String

Um String que representa uma expressão XPath.

resolver
IXmlNamespaceResolver

O objeto IXmlNamespaceResolver usado para resolver prefixos de namespace na consulta XPath.

Retornos

XPathNavigator

Um objeto XPathNavigator que contém o primeiro nó correspondente à consulta XPath especificada; caso contrário, null se não houver resultado da consulta.

Exceções

ArgumentException

Ocorreu um erro na consulta XPath ou o tipo de retorno da expressão XPath não é um nó.

XPathException

A consulta XPath não é válida.

Exemplos

O exemplo a seguir seleciona um único nó do XPathNavigator objeto com base na consulta XPath especificada e usa o XmlNamespaceManager objeto especificado para resolver prefixos de namespace na consulta 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");

XPathNavigator^ node = navigator->SelectSingleNode("//bk:title", manager);
Console::WriteLine(node->InnerXml);

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

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

XPathNavigator node = navigator.SelectSingleNode("//bk:title", manager);
Console.WriteLine(node.InnerXml);

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 node As XPathNavigator = navigator.SelectSingleNode("//bk:title", manager)
Console.WriteLine(node.InnerXml)

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>

Comentários

O SelectSingleNode método seleciona o primeiro nó que corresponde à consulta XPath especificada. O SelectSingleNode método usa o IXmlNamespaceResolver objeto para resolver prefixos de namespace.

Observação

No XPath, todos os namespaces devem ser prefixados em uma consulta. Se um documento XML usar um namespace padrão, você ainda deverá adicionar um prefixo de namespace ao IXmlNamespaceResolver objeto .

Aplica-se a

SelectSingleNode(String)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Seleciona um único nó no XPathNavigator usando a consulta XPath especificada.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (string xpath);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath);
abstract member SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String) As XPathNavigator

Parâmetros

xpath
String

Um String que representa uma expressão XPath.

Retornos

XPathNavigator

Um objeto XPathNavigator que contém o primeiro nó correspondente à consulta XPath especificada; caso contrário, null se não houver resultado da consulta.

Exceções

ArgumentException

Ocorreu um erro na consulta XPath ou o tipo de retorno da expressão XPath não é um nó.

XPathException

A consulta XPath não é válida.

Exemplos

O exemplo a seguir seleciona um único nó do XPathNavigator com base na consulta XPath especificada.

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

XPathNavigator^ node = navigator->SelectSingleNode("//title");
Console::WriteLine(node->InnerXml);

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

XPathNavigator node = navigator.SelectSingleNode("//title");
Console.WriteLine(node.InnerXml);

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

Dim node As XPathNavigator = navigator.SelectSingleNode("//title")
Console.WriteLine(node.InnerXml)

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 SelectSingleNode método seleciona o primeiro nó que corresponde à consulta XPath no XPathNavigator objeto .

Aplica-se a

SelectSingleNode(XPathExpression)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Seleciona um único nó no XPathNavigator usando o objeto XPathExpression especificado.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::Xml::XPath::XPathExpression ^ expression);
public virtual System.Xml.XPath.XPathNavigator? SelectSingleNode (System.Xml.XPath.XPathExpression expression);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (System.Xml.XPath.XPathExpression expression);
abstract member SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (expression As XPathExpression) As XPathNavigator

Parâmetros

expression
XPathExpression

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

Retornos

XPathNavigator

Um objeto XPathNavigator que contém o primeiro nó correspondente à consulta XPath especificada; caso contrário, null se não houver resultado da consulta.

Exceções

ArgumentException

Ocorreu um erro na consulta XPath ou o tipo de retorno da expressão XPath não é um nó.

XPathException

A consulta XPath não é válida.

Exemplos

O exemplo a XPathExpressionseguir seleciona um único nó do XPathNavigator com base na consulta XPath contida no .

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

XPathExpression^ query = navigator->Compile("//title");

XPathNavigator^ node = navigator->SelectSingleNode(query);
Console::WriteLine(node->InnerXml);

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

XPathExpression query = navigator.Compile("//title");

XPathNavigator node = navigator.SelectSingleNode(query);
Console.WriteLine(node.InnerXml);

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

Dim query As XPathExpression = navigator.Compile("//title")

Dim node As XPathNavigator = navigator.SelectSingleNode(query)
Console.WriteLine(node.InnerXml)

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 SelectSingleNode método seleciona o primeiro nó que corresponde à consulta XPath compilada contida no XPathExpression objeto no XPathNavigator.

Aplica-se a