XPathExpression.Compile Méthode

Référence

Définition

Espace de noms:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Compile l'expression XPath spécifiée et retourne un objet XPathExpression qui représente l'expression XPath.

Surcharges

Compile(String)	Compile l’expression XPath spécifiée et retourne un objet XPathExpression représentant l’expression XPath.
Compile(String, IXmlNamespaceResolver)	Compile l'expression XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour la résolution d'espace de noms et retourne un objet XPathExpression qui représente l'expression XPath.

Compile(String)

Compile l’expression XPath spécifiée et retourne un objet XPathExpression représentant l’expression 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

Paramètres

xpath: String

Expression XPath.

Retours

XPathExpression

Objet XPathExpression.

Exceptions

ArgumentException

Le paramètre d’expression XPath n’est pas une expression XPath valide.

XPathException

L’expression XPath n’est pas valide.

Exemples

L’exemple suivant montre comment utiliser le type de retour XPath pour déterminer comment traiter l’expression XPath. L’exemple utilise la Compile méthode pour retourner les nouveaux XPathExpression objets.

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

L'exemple prend le fichier contosoBooks.xml comme entrée.

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

Remarques

Une expression XPath est évaluée pour générer l’un des types de résultats suivants.

Notes

Si une fonction définie par l’utilisateur avec un nombre non valide d’arguments (ou une fonction non implémentée définie par l’utilisateur) est spécifiée dans l’expression XPath, une exception se produit uniquement au moment de l’exécution. Les fonctions définies par l’utilisateur ne sont pas vérifiées au moment de la compilation et les exceptions résultant de fonctions définies par l’utilisateur se produisent uniquement si l’exécution évalue l’expression.

Voir aussi

XPathResultType

S’applique à

Compile(String, IXmlNamespaceResolver)

Compile l'expression XPath spécifiée avec l'objet IXmlNamespaceResolver spécifié pour la résolution d'espace de noms et retourne un objet XPathExpression qui représente l'expression 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

Paramètres

xpath: String

Expression XPath.

nsResolver: IXmlNamespaceResolver

Objet qui implémente l'interface IXmlNamespaceResolver pour la résolution d'espace de noms.

Retours

XPathExpression

Objet XPathExpression.

Exceptions

ArgumentException

Le paramètre d’expression XPath n’est pas une expression XPath valide.

XPathException

L’expression XPath n’est pas valide.

Remarques

Une expression XPath est évaluée pour générer l’un des types de résultats suivants.

Notes

Si une fonction définie par l’utilisateur avec un nombre d’arguments non valide (ou une fonction non implémentée définie par l’utilisateur) est spécifiée dans l’expression XPath, une exception se produit uniquement au moment de l’exécution. Les fonctions définies par l’utilisateur ne sont pas vérifiées au moment de la compilation et les exceptions résultant de fonctions définies par l’utilisateur se produisent uniquement si l’exécution évalue l’expression.

Notes

Il n’est pas possible de compiler une XPathExpression avec un contexte personnalisé en passant un XsltContext, qui implémente IXmlNamespaceResolver, en tant qu’argument à cette méthode. Pour utiliser un XPathExpression contexte personnalisé, vous devez appeler la SetContext méthode après avoir compilé l’expression.

Voir aussi

S’applique à

Partager via

XPathExpression.Compile Méthode

Définition

Surcharges

Compile(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Compile(String, IXmlNamespaceResolver)

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Ressources supplémentaires