XPathNavigator.Evaluate Método

Definição

Espaço de Nomes:: System.Xml.XPath

Assemblagens:: netstandard.dll, System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.XPath.dll

Assemblagem:: System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Avalia a expressão XPath especificada e devolve o resultado tipado.

Sobrecargas

Name	Description
Evaluate(String)	Avalia a expressão XPath especificada e devolve o resultado tipado.
Evaluate(XPathExpression)	Avalia o XPathExpression e devolve o resultado digitado.
Evaluate(String, IXmlNamespaceResolver)	Avalia a expressão XPath especificada e retorna o resultado tipado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace na expressão XPath.
Evaluate(XPathExpression, XPathNodeIterator)	Utiliza o contexto fornecido para avaliar o XPathExpression, e devolve o resultado tipado.

Evaluate(String)

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Avalia a expressão XPath especificada e devolve o resultado tipado.

public:
 virtual System::Object ^ Evaluate(System::String ^ xpath);

public virtual object Evaluate(string xpath);

abstract member Evaluate : string -> obj
override this.Evaluate : string -> obj

Public Overridable Function Evaluate (xpath As String) As Object

Parâmetros

xpath: String

Uma cadeia que representa uma expressão XPath que pode ser avaliada.

Devoluções

Object

O resultado da expressão (Booleano, número, cadeia ou conjunto de nós). Isto mapeia para Boolean, Double, String, ou XPathNodeIterator objetos, respetivamente.

Exceções

ArgumentException

O tipo de retorno da expressão XPath é um conjunto de nós.

XPathException

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

Exemplos

O exemplo seguinte avalia uma expressão XPath e devolve um Double.

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

Double total = (double)navigator.Evaluate("sum(descendant::book/price)");
Console.WriteLine("Total price for all books: {0}", total.ToString());

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

Dim total As Double = CType(navigator.Evaluate("sum(descendant::book/price)"), Double)
Console.WriteLine("Total price for all books: {0}", total.ToString())

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>

Observações

O código C# seguinte converte o Price/text() nó num número, multiplica-o por 10 e devolve o valor resultante.

nav.Evaluate("Price/text()*10");

Note

As funções XPath position() e last(), a menos que sejam usadas como predicado num passo de localização, requerem uma referência a um conjunto de nós para serem avaliadas. Neste caso, deve usar a sobrecarga que toma a XPathNodeIterator como argumento; caso contrário, posição() e último() retornam 0.

Este método não tem efeito no estado do XPathNavigator.

Ver também

Aplica-se a

Evaluate(XPathExpression)

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Avalia o XPathExpression e devolve o resultado digitado.

public:
 virtual System::Object ^ Evaluate(System::Xml::XPath::XPathExpression ^ expr);

public virtual object Evaluate(System.Xml.XPath.XPathExpression expr);

abstract member Evaluate : System.Xml.XPath.XPathExpression -> obj
override this.Evaluate : System.Xml.XPath.XPathExpression -> obj

Public Overridable Function Evaluate (expr As XPathExpression) As Object

Parâmetros

expr: XPathExpression

E XPathExpression isso pode ser avaliado.

Devoluções

Object

O resultado da expressão (Booleano, número, cadeia ou conjunto de nós). Isto mapeia para Boolean, Double, String, ou XPathNodeIterator objetos, respetivamente.

Exceções

ArgumentException

O tipo de retorno da expressão XPath é um conjunto de nós.

XPathException

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

Exemplos

O exemplo seguinte avalia um XPathExpression e devolve um Double.

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

XPathExpression query = navigator.Compile("sum(descendant::book/price)");

Double total = (double)navigator.Evaluate(query);
Console.WriteLine("Total price for all books: {0}", total.ToString());

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

Dim query As XPathExpression = navigator.Compile("sum(descendant::book/price)")

Dim total As Double = CType(navigator.Evaluate(query), Double)
Console.WriteLine("Total price for all books: {0}", total.ToString())

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>

Observações

O código C# seguinte devolve um número após converter o Price/text() nó num número e multiplicar o valor por 10.

XPathExpression expr = nav.Compile("Price/text()*10");
nav.Evaluate(expr);

Note

Este método não tem efeito no estado do XPathNavigator.

Ver também

Aplica-se a

Evaluate(String, IXmlNamespaceResolver)

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Avalia a expressão XPath especificada e retorna o resultado tipado, usando o IXmlNamespaceResolver objeto especificado para resolver prefixos de namespace na expressão XPath.

public:
 virtual System::Object ^ Evaluate(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ resolver);

public virtual object Evaluate(string xpath, System.Xml.IXmlNamespaceResolver? resolver);

public virtual object Evaluate(string xpath, System.Xml.IXmlNamespaceResolver resolver);

abstract member Evaluate : string * System.Xml.IXmlNamespaceResolver -> obj
override this.Evaluate : string * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function Evaluate (xpath As String, resolver As IXmlNamespaceResolver) As Object

Parâmetros

xpath: String

Uma cadeia que representa uma expressão XPath que pode ser avaliada.

resolver: IXmlNamespaceResolver

O IXmlNamespaceResolver objeto usado para resolver prefixos de namespace na expressão XPath.

Devoluções

Object

O resultado da expressão (Booleano, número, cadeia ou conjunto de nós). Isto mapeia para Boolean, Double, String, ou XPathNodeIterator objetos, respetivamente.

Exceções

ArgumentException

O tipo de retorno da expressão XPath é um conjunto de nós.

XPathException

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

Exemplos

O exemplo seguinte avalia uma expressão XPath e retorna um Double usando o XmlNamespaceManager objeto especificado para resolver prefixos de namespace na expressão 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");

Double total = (double)navigator.Evaluate("sum(descendant::bk:book/bk:price)", manager);
Console.WriteLine("Total price for all books: {0}", total.ToString());

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 total As Double = CType(navigator.Evaluate("sum(descendant::bk:book/bk:price)", manager), Double)
Console.WriteLine("Total price for all books: {0}", total.ToString())

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>

Observações

O código C# seguinte devolve um número após converter o Price/text() nó num número e multiplicar o valor por 10.

XPathExpression expr = nav.Compile("Price/text()*10");
nav.Evaluate(expr);

Note

Este método não tem efeito no estado do XPathNavigator.

Aplica-se a

Evaluate(XPathExpression, XPathNodeIterator)

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Origem:: XPathNavigator.cs

Utiliza o contexto fornecido para avaliar o XPathExpression, e devolve o resultado tipado.

public:
 virtual System::Object ^ Evaluate(System::Xml::XPath::XPathExpression ^ expr, System::Xml::XPath::XPathNodeIterator ^ context);

public virtual object Evaluate(System.Xml.XPath.XPathExpression expr, System.Xml.XPath.XPathNodeIterator? context);

public virtual object Evaluate(System.Xml.XPath.XPathExpression expr, System.Xml.XPath.XPathNodeIterator context);

abstract member Evaluate : System.Xml.XPath.XPathExpression * System.Xml.XPath.XPathNodeIterator -> obj
override this.Evaluate : System.Xml.XPath.XPathExpression * System.Xml.XPath.XPathNodeIterator -> obj

Public Overridable Function Evaluate (expr As XPathExpression, context As XPathNodeIterator) As Object

Parâmetros

expr: XPathExpression

E XPathExpression isso pode ser avaliado.

context: XPathNodeIterator

E XPathNodeIterator que aponta para o conjunto de nós selecionado onde a avaliação deve ser realizada.

Devoluções

Object

O resultado da expressão (Booleano, número, cadeia ou conjunto de nós). Isto mapeia para Boolean, Double, String, ou XPathNodeIterator objetos, respetivamente.

Exceções

ArgumentException

O tipo de retorno da expressão XPath é um conjunto de nós.

XPathException

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

Exemplos

O exemplo seguinte avalia um XPathExpression e devolve um Double usando o Current nó de como XPathNodeIterator o nó de contexto.

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

XPathNodeIterator nodes = navigator.Select("//book");
XPathExpression query = nodes.Current.Compile("sum(descendant::price)");

Double total = (double)navigator.Evaluate(query, nodes);
Console.WriteLine("Total price for all books: {0}", total.ToString());

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

Dim nodes As XPathNodeIterator = navigator.Select("//book")
Dim query As XPathExpression = nodes.Current.Compile("sum(descendant::price)")

Dim total As Double = CType(navigator.Evaluate(query, nodes), Double)
Console.WriteLine("Total price for all books: {0}", total.ToString())

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>

Observações

A expressão é avaliada usando o Current nó de o XPathNodeIterator como nó de contexto. Se context for null, o nó onde o XPathNavigator está atualmente posicionado é usado como nó de contexto.

As funções position() e last(), salvo serem usadas como predicado num passo de localização, retornam sempre 0 sob as seguintes condições:

O context argumento é null.
MoveNext não foi chamado no XPathNodeIterator.

Como as funções position() e last() funcionam no nó atual, não deve usar a Current propriedade para se afastar do conjunto de nós selecionado. Isto poderia invalidar o estado do XPathNavigator.

Este método não tem efeito no estado do XPathNavigator.

Aplica-se a

Comentários

Esta página foi útil?