XPathExpression.Compile Methode

Definitie

Naamruimte:: System.Xml.XPath

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

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Compileert de opgegeven XPath-expressie en retourneert een XPathExpression object dat de XPath-expressie vertegenwoordigt.

Overloads

Name	Description
Compile(String)	Compileert de opgegeven XPath-expressie en retourneert een XPathExpression object dat de XPath-expressie vertegenwoordigt.
Compile(String, IXmlNamespaceResolver)	Compileert de opgegeven XPath-expressie, waarbij het IXmlNamespaceResolver object is opgegeven voor naamruimteomzetting en retourneert een XPathExpression object dat de XPath-expressie vertegenwoordigt.

Compile(String)

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Compileert de opgegeven XPath-expressie en retourneert een XPathExpression object dat de XPath-expressie vertegenwoordigt.

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

Parameters

xpath: String

Een XPath-expressie.

Retouren

XPathExpression

Een XPathExpression object.

Uitzonderingen

ArgumentException

De XPath-expressieparameter is geen geldige XPath-expressie.

XPathException

De XPath-expressie is ongeldig.

Voorbeelden

In het volgende voorbeeld ziet u hoe u het XPath-retourtype gebruikt om te bepalen hoe de XPath-expressie moet worden verwerkt. In het voorbeeld wordt de Compile methode gebruikt om de nieuwe XPathExpression objecten te retourneren.

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 het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

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

Opmerkingen

Een XPath-expressie wordt geëvalueerd om een van de volgende resultaattypen te genereren.

Note

Als een door de gebruiker gedefinieerde functie met een ongeldig aantal argumenten (of een niet-geïmplementeerde door de gebruiker gedefinieerde functie) is opgegeven in de XPath-expressie, treedt er alleen een uitzondering op tijdens de runtime. Door de gebruiker gedefinieerde functies worden niet gecontroleerd tijdens het compileren en uitzonderingen die het resultaat zijn van door de gebruiker gedefinieerde functies, vinden alleen plaats als de uitvoering de expressie evalueert.

Zie ook

XPathResultType

Van toepassing op

Compile(String, IXmlNamespaceResolver)

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Bron:: XPathExpr.cs

Compileert de opgegeven XPath-expressie, waarbij het IXmlNamespaceResolver object is opgegeven voor naamruimteomzetting en retourneert een XPathExpression object dat de XPath-expressie vertegenwoordigt.

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

Parameters

xpath: String

Een XPath-expressie.

nsResolver: IXmlNamespaceResolver

Een object dat de IXmlNamespaceResolver interface voor naamruimteomzetting implementeert.

Retouren

XPathExpression

Een XPathExpression object.

Uitzonderingen

ArgumentException

De XPath-expressieparameter is geen geldige XPath-expressie.

XPathException

De XPath-expressie is ongeldig.

Opmerkingen

Een XPath-expressie wordt geëvalueerd om een van de volgende resultaattypen te genereren.

Note

Als een door de gebruiker gedefinieerde functie met een ongeldig aantal argumenten (of een niet-geïmplementeerde door de gebruiker gedefinieerde functie) is opgegeven in de XPath-expressie, treedt er alleen een uitzondering op tijdens runtime. Door de gebruiker gedefinieerde functies worden niet gecontroleerd tijdens het compileren en uitzonderingen die voortvloeien uit door de gebruiker gedefinieerde functies, worden alleen uitgevoerd als de expressie wordt geëvalueerd.

Note

Het is niet mogelijk om een XPathExpression met een aangepaste context in één stap te compileren XsltContextdoor een IXmlNamespaceResolver, die implementeert , als argument voor deze methode door te geven. Als u een XPathExpression met een aangepaste context wilt gebruiken, moet u de SetContext methode aanroepen na het compileren van de expressie.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?