XPathNavigator.SelectSingleNode Método

Definição

Namespace:: System.Xml.XPath

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 único nó no XPathNavigator.

Sobrecargas

Nome	Description
SelectSingleNode(String, IXmlNamespaceResolver)	Seleciona um único nó no XPathNavigator objeto usando a consulta XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace.
SelectSingleNode(String)	Seleciona um único nó na XPathNavigator consulta XPath especificada.
SelectSingleNode(XPathExpression)	Seleciona um único nó no XPathNavigator uso do objeto especificado XPathExpression .

SelectSingleNode(String, IXmlNamespaceResolver)

Seleciona um único nó no XPathNavigator objeto usando a consulta XPath especificada com o IXmlNamespaceResolver objeto especificado para resolver 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);

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

Uma String expressão XPath que representa.

resolver: IXmlNamespaceResolver

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

Retornos

XPathNavigator

Um XPathNavigator objeto que contém o primeiro nó correspondente para a consulta XPath especificada; caso contrário null , se não houver resultados de consulta.

Exceções

ArgumentException

Um erro foi encontrado 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 = 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 contosoBooks.xml arquivo como uma 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.

Note

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)

Seleciona um único nó na XPathNavigator consulta XPath especificada.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::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

Uma String expressão XPath que representa.

Retornos

XPathNavigator

Um XPathNavigator objeto que contém o primeiro nó correspondente para a consulta XPath especificada; caso contrário, null se não houver resultados de consulta.

Exceções

ArgumentException

Um erro foi encontrado 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ó XPathNavigator com base na consulta XPath especificada.

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 books.xml arquivo como uma 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)

Seleciona um único nó no XPathNavigator uso do objeto especificado XPathExpression .

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 XPathExpression objeto que contém a consulta XPath compilada.

Retornos

XPathNavigator

Um XPathNavigator objeto que contém o primeiro nó correspondente para a consulta XPath especificada; caso contrário null , se não houver resultados de consulta.

Exceções

ArgumentException

Um erro foi encontrado 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ó XPathNavigator com base na consulta XPath contida no .

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 books.xml arquivo como uma 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

Comentários

Esta página foi útil?