XPathExpression.Compile Metodo

Definizione

Spazio dei nomi:: System.Xml.XPath

Assembly:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.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 XPathExpression oggetto che rappresenta l'espressione XPath.

Overload

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

Compile(String)

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

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

Valori restituiti

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 utilizzare il tipo restituito XPath per determinare come elaborare l'espressione XPath. Nell'esempio viene utilizzato 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

L'esempio accetta il file contosoBooks.xml 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.

Note

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, viene generata un'eccezione solo in fase di esecuzione. Le funzioni definite dall'utente non vengono controllate in fase di compilazione e le 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)

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

Origine:: XPathExpr.cs

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

Valori restituiti

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.

Note

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 e le eccezioni risultanti dalle funzioni definite dall'utente si verificano solo se l'esecuzione valuta l'espressione.

Note

Non è possibile compilare un XPathExpression oggetto con un contesto personalizzato in un unico passaggio passando un XsltContextoggetto , 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

Commenti e suggerimenti

Questa pagina è stata utile?