XPathExpression.Compile Método

  • Referencia

Definición

Espacio de nombres:
System.Xml.XPath
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.XPath.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll

Compila la expresión XPath especificada y devuelve un objeto XPathExpression que representa la expresión XPath.

Sobrecargas

Compile(String)

Compila la expresión XPath especificada y devuelve un objeto XPathExpression que representa la expresión XPath.
Compile(String, IXmlNamespaceResolver)

Compila la expresión XPath especificada, con el objeto IXmlNamespaceResolver especificado para la resolución de espacio de nombres y devuelve un objeto XPathExpression que representa la expresión XPath.

Compile(String)

Compila la expresión XPath especificada y devuelve un objeto XPathExpression que representa la expresión 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

Expresión XPath.

Devoluciones

XPathExpression

Un objeto XPathExpression.

Excepciones

ArgumentException

El parámetro de la expresión XPath no es una expresión XPath válida.

XPathException

La expresión XPath no es válida.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el tipo de valor devuelto XPath para determinar cómo procesar la expresión XPath. En el ejemplo se usa el Compile método para devolver los nuevos 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

En el ejemplo se toma como entrada el archivo contosoBooks.xml.

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

Comentarios

Se evalúa una expresión XPath para producir uno de los siguientes tipos de resultado.

Nota

Si se especifica una función definida por el usuario con un número no válido de argumentos (o una función definida por el usuario no implementada) en la expresión XPath, solo se produce una excepción en tiempo de ejecución. Las funciones definidas por el usuario no se comprueban en tiempo de compilación y las excepciones resultantes de las funciones definidas por el usuario solo se producen si la ejecución evalúa la expresión.

Consulte también

Se aplica a

Compile(String, IXmlNamespaceResolver)

Compila la expresión XPath especificada, con el objeto IXmlNamespaceResolver especificado para la resolución de espacio de nombres y devuelve un objeto XPathExpression que representa la expresión 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);
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

Expresión XPath.

nsResolver
IXmlNamespaceResolver

Un objeto que implementa la interfaz IXmlNamespaceResolver para la resolución de espacio de nombres.

Devoluciones

XPathExpression

Un objeto XPathExpression.

Excepciones

ArgumentException

El parámetro de la expresión XPath no es una expresión XPath válida.

XPathException

La expresión XPath no es válida.

Comentarios

Se evalúa una expresión XPath para producir uno de los siguientes tipos de resultado.

Nota

Si se especifica una función definida por el usuario con un número no válido de argumentos (o una función definida por el usuario no implementada) en la expresión XPath, se produce una excepción solo en tiempo de ejecución. Las funciones definidas por el usuario no se comprueban en tiempo de compilación y las excepciones resultantes de las funciones definidas por el usuario solo se producen si la ejecución evalúa la expresión.

Nota

No es posible compilar con XPathExpression un contexto personalizado en un paso pasando un XsltContext, que implementa IXmlNamespaceResolver, como argumento para este método. Para usar un XPathExpression con un contexto personalizado, debe llamar al SetContext método después de compilar la expresión.

Consulte también

Se aplica a