XPathExpression.Compile Méthode
Définition
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
Objet XPathExpression.
Exceptions
Le paramètre d’expression XPath n’est pas une expression XPath valide.
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
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
Objet XPathExpression.
Exceptions
Le paramètre d’expression XPath n’est pas une expression XPath valide.
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.