XPathExpression.Compile Methode

Definition

Namespace:: System.Xml.XPath

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

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
Compile(String)	Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpression Objekt zurück, das den XPath-Ausdruck darstellt.
Compile(String, IXmlNamespaceResolver)	Kompiliert den angegebenen XPath-Ausdruck mit dem für die IXmlNamespaceResolver Namespaceauflösung angegebenen Objekt und gibt ein XPathExpression Objekt zurück, das den XPath-Ausdruck darstellt.

Compile(String)

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Kompiliert den angegebenen XPath-Ausdruck und gibt ein XPathExpression Objekt 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

ArgumentException

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

XPathException

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

Im Beispiel wird die contosoBooks.xml Datei 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.

Note

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 aus benutzerdefinierten Funktionen resultieren, treten nur auf, wenn die Ausführung den Ausdruck auswertet.

Weitere Informationen

XPathResultType

Gilt für:

Compile(String, IXmlNamespaceResolver)

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Quelle:: XPathExpr.cs

Kompiliert den angegebenen XPath-Ausdruck mit dem für die IXmlNamespaceResolver Namespaceauflösung angegebenen Objekt 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 Schnittstelle für die IXmlNamespaceResolver Namespaceauflösung implementiert.

Gibt zurück

XPathExpression

Ein XPathExpression-Objekt.

Ausnahmen

ArgumentException

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

XPathException

Der XPath-Ausdruck ist ungültig.

Hinweise

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

Note

Wenn eine benutzerdefinierte Funktion mit einer ungültigen Anzahl von Argumenten (oder einer nicht implementierten benutzerdefinierten Funktion) im XPath-Ausdruck angegeben wird, tritt eine Ausnahme nur zur Laufzeit 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.

Note

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?