Freigeben über


XPathExpression.Compile Methode

Definition

Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpression-Objekt zurück, das den XPath-Ausdruck darstellt.

Überlädt

Compile(String)

Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpressionObjekt zurück, das den XPath-Ausdruck darstellt.

Compile(String, IXmlNamespaceResolver)

Kompiliert den angegebenen XPath-Ausdruck, wobei das IXmlNamespaceResolver-Objekt für die Namespaceauflösung angegeben ist, und gibt ein XPathExpression-Objekt zurück, das den XPath-Ausdruck darstellt.

Compile(String)

Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpressionObjekt zurück, das den XPath-Ausdruck darstellt.

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

Parameter

xpath
String

Ein XPath-Ausdruck.

Gibt zurück

XPathExpression

Ein XPathExpression-Objekt.

Ausnahmen

Der XPath-Ausdrucksparameter ist kein gültiger XPath-Ausdruck.

Der XPath-Ausdruck ist ungültig.

Beispiele

Das folgende Beispiel zeigt, wie Der XPath-Rückgabetyp verwendet wird, um zu bestimmen, wie der XPath-Ausdruck verarbeitet wird. Im Beispiel wird die Compile Methode verwendet, um die neuen XPathExpression Objekte zurückzugeben.

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

In diesem Beispiel wird die Datei contosoBooks.xml als Eingabe verwendet.

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

Hinweise

Ein XPath-Ausdruck wird ausgewertet, um einen der folgenden Ergebnistypen zu erzielen.

Hinweis

Wenn eine benutzerdefinierte Funktion mit einer ungültigen Anzahl von Argumenten (oder einer nicht implementierten benutzerdefinierten Funktion) im XPath-Ausdruck angegeben wird, tritt nur zur Laufzeit eine Ausnahme auf. Benutzerdefinierte Funktionen werden zur Kompilierungszeit nicht überprüft, und Ausnahmen, die sich aus benutzerdefinierten Funktionen ergeben, treten nur auf, wenn die Ausführung den Ausdruck auswertet.

Siehe auch

Gilt für

Compile(String, IXmlNamespaceResolver)

Kompiliert den angegebenen XPath-Ausdruck, wobei das IXmlNamespaceResolver-Objekt für die Namespaceauflösung angegeben ist, und gibt ein XPathExpression-Objekt zurück, das den XPath-Ausdruck darstellt.

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

Parameter

xpath
String

Ein XPath-Ausdruck.

nsResolver
IXmlNamespaceResolver

Ein Objekt, das die IXmlNamespaceResolver-Schnittstelle für die Namespaceauflösung implementiert.

Gibt zurück

XPathExpression

Ein XPathExpression-Objekt.

Ausnahmen

Der XPath-Ausdrucksparameter ist kein gültiger XPath-Ausdruck.

Der XPath-Ausdruck ist ungültig.

Hinweise

Ein XPath-Ausdruck wird ausgewertet, um einen der folgenden Ergebnistypen zu erzielen.

Hinweis

Wenn eine benutzerdefinierte Funktion mit einer ungültigen Anzahl von Argumenten (oder einer nicht implementierten benutzerdefinierten Funktion) im XPath-Ausdruck angegeben wird, tritt nur zur Laufzeit eine Ausnahme auf. Benutzerdefinierte Funktionen werden zur Kompilierungszeit nicht überprüft, und Ausnahmen, die sich aus benutzerdefinierten Funktionen ergeben, treten nur auf, wenn die Ausführung den Ausdruck auswertet.

Hinweis

Es ist nicht möglich, einen XPathExpression benutzerdefinierten Kontext in einem Schritt zu kompilieren, indem ein XsltContext, das implementiert IXmlNamespaceResolverwird, als Argument an diese Methode übergeben. Um einen XPathExpression benutzerdefinierten Kontext zu verwenden, müssen Sie die SetContext Methode aufrufen, nachdem Sie den Ausdruck kompiliert haben.

Siehe auch

Gilt für