XPathExpression.Compile Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Compila l'espressione XPath specificata e restituisce un oggetto XPathExpression che rappresenta l'espressione XPath.

Overload

Compile(String)	Compila l'espressione XPath specificata e restituisce un oggetto XPathExpression che rappresenta l'espressione XPath.
Compile(String, IXmlNamespaceResolver)	Compila l'espressione XPath specificata, con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dello spazio dei nomi, e restituisce un oggetto XPathExpression che rappresenta l'espressione XPath.

Compile(String)

Compila l'espressione XPath specificata e restituisce un oggetto XPathExpression che rappresenta l'espressione 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

Parametri

xpath: String

Espressione XPath.

Restituisce

XPathExpression

Oggetto XPathExpression.

Eccezioni

ArgumentException

Il parametro dell'espressione XPath non è un'espressione XPath valida.

XPathException

L’espressione XPath non è valida.

Esempio

Nell'esempio seguente viene illustrato come usare il tipo restituito XPath per determinare come elaborare l'espressione XPath. L'esempio usa il Compile metodo per restituire i nuovi XPathExpression oggetti.

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

Nell'esempio il file contosoBooks.xml viene considerato come input.

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

Commenti

Un'espressione XPath viene valutata per restituire uno dei tipi di risultati seguenti.

Nota

Se una funzione definita dall'utente con un numero di argomenti non valido (o una funzione definita dall'utente non implementata) viene specificata nell'espressione XPath, un'eccezione si verifica solo in fase di esecuzione. Le funzioni definite dall'utente non vengono controllate in fase di compilazione ed eccezioni risultanti dalle funzioni definite dall'utente si verificano solo se l'esecuzione valuta l'espressione.

Vedi anche

XPathResultType

Si applica a

Compile(String, IXmlNamespaceResolver)

Compila l'espressione XPath specificata, con l'oggetto IXmlNamespaceResolver specificato per la risoluzione dello spazio dei nomi, e restituisce un oggetto XPathExpression che rappresenta l'espressione 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

Parametri

xpath: String

Espressione XPath.

nsResolver: IXmlNamespaceResolver

Oggetto che implementa l'interfaccia IXmlNamespaceResolver per la risoluzione dello spazio dei nomi.

Restituisce

XPathExpression

Oggetto XPathExpression.

Eccezioni

ArgumentException

Il parametro dell'espressione XPath non è un'espressione XPath valida.

XPathException

L’espressione XPath non è valida.

Commenti

Un'espressione XPath viene valutata per restituire uno dei tipi di risultati seguenti.

Nota

Non è possibile compilare un XPathExpression oggetto con un contesto personalizzato in un passaggio passando XsltContextun oggetto , che implementa IXmlNamespaceResolver, come argomento a questo metodo. Per usare un XPathExpression oggetto con un contesto personalizzato, è necessario chiamare il SetContext metodo dopo la compilazione dell'espressione.

Vedi anche

Si applica a

XPathExpression.Compile Metodo

Definizione

Overload

Compile(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Compile(String, IXmlNamespaceResolver)

Parametri

Restituisce

Eccezioni

Commenti

Vedi anche

Si applica a

Risorse aggiuntive