XPathExpression.Compile Método

Definição

Espaço de Nomes:
System.Xml.XPath
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Compila a expressão XPath especificada e devolve um XPathExpression objeto que representa a expressão XPath.

Sobrecargas

Name Description
Compile(String)

Compila a expressão XPath especificada e devolve um XPathExpression objeto que representa a expressão XPath.
Compile(String, IXmlNamespaceResolver)

Compila a expressão XPath especificada, com o IXmlNamespaceResolver objeto especificado para resolução do namespace, e retorna um XPathExpression objeto que representa a expressão XPath.

Compile(String)

Compila a expressão XPath especificada e devolve um XPathExpression objeto que representa a expressão XPath.

public:
 static System::Xml::XPath::XPathExpression ^ Compile(System::String ^ xpath);
public static System.Xml.XPath.XPathExpression Compile(string xpath);
static member Compile : string -> System.Xml.XPath.XPathExpression
Public Shared Function Compile (xpath As String) As XPathExpression

Parâmetros

xpath
String

Uma expressão XPath.

Devoluções

XPathExpression

Um XPathExpression objeto.

Exceções

ArgumentException

O parâmetro de expressão XPath não é uma expressão XPath válida.

XPathException

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

Exemplos

O exemplo seguinte mostra como usar o tipo de retorno XPath para determinar como processar a expressão XPath. O exemplo usa o Compile método para devolver os novos XPathExpression objetos.

public ref class Sample
{
public:
   static void Evaluate( XPathExpression^ expr, XPathNavigator^ nav )
   {
      XPathNodeIterator^ i = nav->Select(expr);
      switch ( expr->ReturnType )
      {
         case XPathResultType::Number:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;

         case XPathResultType::NodeSet:
            while ( i->MoveNext() )
                        Console::WriteLine( i->Current );
            break;

         case XPathResultType::Boolean:
            if ( *safe_cast<bool^>(nav->Evaluate( expr )) )
                        Console::WriteLine( "True!" );
            break;

         case XPathResultType::String:
            Console::WriteLine( nav->Evaluate( expr ) );
            break;
      }
   }

};

int main()
{
   XPathDocument^ doc = gcnew XPathDocument( "contosoBooks.xml" );
   XPathNavigator^ nav = doc->CreateNavigator();
   XPathExpression^ expr1 = nav->Compile( ".//price/text()*10" ); // Returns a number.

   XPathExpression^ expr2 = nav->Compile( "bookstore/book/price" ); // Returns a nodeset.

   Sample^ MySample = gcnew Sample;
   MySample->Evaluate( expr1, nav );
   MySample->Evaluate( expr2, nav );
}

using System;
using System.Xml;
using System.Xml.XPath;

public class XPathExpressionExample
{
    public static void Main()
    {
        XPathDocument document = new XPathDocument("contosoBooks.xml");
        XPathNavigator navigator = document.CreateNavigator();

        XPathExpression expression1 = XPathExpression.Compile(".//bk:price/text()*10"); // Returns a number.
        XPathExpression expression2 = XPathExpression.Compile("bk:bookstore/bk:book/bk:price"); // Returns a nodeset.

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

        expression1.SetContext(manager);
        expression2.SetContext(manager);

        Evaluate(expression1, navigator);
        Evaluate(expression2, navigator);
    }

    public static void Evaluate(XPathExpression expression, XPathNavigator navigator)
    {
        switch (expression.ReturnType)
        {
            case XPathResultType.Number:
                Console.WriteLine(navigator.Evaluate(expression));
                break;

            case XPathResultType.NodeSet:
                XPathNodeIterator nodes = navigator.Select(expression);
                while (nodes.MoveNext())
                {
                    Console.WriteLine(nodes.Current.ToString());
                }
                break;

            case XPathResultType.Boolean:
                if ((bool)navigator.Evaluate(expression))
                    Console.WriteLine("True!");
                break;

            case XPathResultType.String:
                Console.WriteLine(navigator.Evaluate(expression));
                break;
        }
    }
}

Imports System.Xml
Imports System.Xml.XPath

Public Class XPathExpressionExample

    Public Shared Sub Main()
        Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
        Dim navigator As XPathNavigator = document.CreateNavigator()

        Dim expression1 As XPathExpression = XPathExpression.Compile(".//bk:price/text()*10")  ' Returns a number.
        Dim expression2 As XPathExpression = XPathExpression.Compile("bk:bookstore/bk:book/bk:price")  ' Returns a nodeset.

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

        expression1.SetContext(manager)
        expression2.SetContext(manager)

        Evaluate(expression1, navigator)
        Evaluate(expression2, navigator)

    End Sub

    Public Shared Sub Evaluate(ByVal expression As XPathExpression, ByVal navigator As XPathNavigator)

        Select Case expression.ReturnType
            Case XPathResultType.Number
                Console.WriteLine(navigator.Evaluate(expression))
                Exit Sub

            Case XPathResultType.NodeSet
                Dim nodes As XPathNodeIterator = navigator.Select(expression)
                While nodes.MoveNext()
                    Console.WriteLine(nodes.Current.ToString())
                End While

            Case XPathResultType.Boolean
                If CType(navigator.Evaluate(expression), Boolean) Then
                    Console.WriteLine("True!")
                End If

            Case XPathResultType.String
                Console.WriteLine(navigator.Evaluate(expression))
        End Select

    End Sub
End Class

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>

Observações

Uma expressão XPath é avaliada para produzir um dos seguintes tipos de resultados.

Note

Se uma função definida pelo utilizador com um número inválido de argumentos (ou uma função definida pelo utilizador não implementada) for especificada na expressão XPath, uma exceção ocorre apenas em tempo de execução. As funções definidas pelo utilizador não são verificadas em tempo de compilação e as exceções que resultam de funções definidas pelo utilizador só ocorrem se a execução avaliar a expressão.

Ver também

Aplica-se a

Compile(String, IXmlNamespaceResolver)

Compila a expressão XPath especificada, com o IXmlNamespaceResolver objeto especificado para resolução do namespace, e retorna um XPathExpression objeto que representa a expressão XPath.

public:
 static System::Xml::XPath::XPathExpression ^ Compile(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ nsResolver);
public static System.Xml.XPath.XPathExpression Compile(string xpath, System.Xml.IXmlNamespaceResolver nsResolver);
static member Compile : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathExpression
Public Shared Function Compile (xpath As String, nsResolver As IXmlNamespaceResolver) As XPathExpression

Parâmetros

xpath
String

Uma expressão XPath.

nsResolver
IXmlNamespaceResolver

Um objeto que implementa a IXmlNamespaceResolver interface para resolução de namespace.

Devoluções

XPathExpression

Um XPathExpression objeto.

Exceções

ArgumentException

O parâmetro de expressão XPath não é uma expressão XPath válida.

XPathException

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

Observações

Uma expressão XPath é avaliada para produzir um dos seguintes tipos de resultados.

Note

Se uma função definida pelo utilizador com um número inválido de argumentos (ou uma função definida pelo utilizador não implementada) for especificada na expressão XPath, uma exceção ocorre apenas em tempo de execução. As funções definidas pelo utilizador não são verificadas em tempo de compilação e as exceções resultantes de funções definidas pelo utilizador só ocorrem se a execução avaliar a expressão.

Note

Não é possível compilar a XPathExpression com um contexto personalizado numa só etapa, passando um XsltContext, que implementa IXmlNamespaceResolver, como argumento para este método. Para usar a XPathExpression com um contexto personalizado, deve chamar o SetContext método após compilar a expressão.

Ver também

Aplica-se a