XPathExpression.Compile Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.XPath

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.XPath.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Kompiluje określone wyrażenie XPath i zwraca XPathExpression obiekt reprezentujący wyrażenie XPath.

Przeciążenia

Compile(String)	Kompiluje określone wyrażenie XPath i zwraca XPathExpression obiekt reprezentujący wyrażenie XPath.
Compile(String, IXmlNamespaceResolver)	Kompiluje określone wyrażenie XPath z obiektem IXmlNamespaceResolver określonym dla rozpoznawania przestrzeni nazw i zwraca XPathExpression obiekt reprezentujący wyrażenie XPath.

Compile(String)

Kompiluje określone wyrażenie XPath i zwraca XPathExpression obiekt reprezentujący wyrażenie 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

Parametry

xpath: String

Wyrażenie XPath.

Zwraca

XPathExpression

Obiekt XPathExpression.

Wyjątki

ArgumentException

Parametr wyrażenia XPath nie jest prawidłowym wyrażeniem XPath.

XPathException

Wyrażenie XPath jest nieprawidłowe.

Przykłady

W poniższym przykładzie pokazano, jak za pomocą zwracanego typu XPath określić sposób przetwarzania wyrażenia XPath. W przykładzie użyto Compile metody , aby zwrócić nowe XPathExpression obiekty.

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

W przykładzie plik jest pobierany contosoBooks.xml jako dane wejściowe.

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

Uwagi

Wyrażenie XPath jest oceniane w celu uzyskania jednego z następujących typów wyników.

Uwaga

Jeśli zdefiniowana przez użytkownika funkcja z nieprawidłową liczbą argumentów (lub niezaimplementowaną funkcją zdefiniowaną przez użytkownika) jest określona w wyrażeniu XPath, wyjątek występuje tylko w czasie wykonywania. Funkcje zdefiniowane przez użytkownika nie są sprawdzane w czasie kompilacji i wyjątki wynikające z funkcji zdefiniowanych przez użytkownika występują tylko wtedy, gdy wykonanie ocenia wyrażenie.

Zobacz też

XPathResultType

Dotyczy

Compile(String, IXmlNamespaceResolver)

Kompiluje określone wyrażenie XPath z obiektem IXmlNamespaceResolver określonym dla rozpoznawania przestrzeni nazw i zwraca XPathExpression obiekt reprezentujący wyrażenie 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

Parametry

xpath: String

Wyrażenie XPath.

nsResolver: IXmlNamespaceResolver

Obiekt, który implementuje IXmlNamespaceResolver interfejs do rozpoznawania przestrzeni nazw.

Zwraca

XPathExpression

Obiekt XPathExpression.

Wyjątki

ArgumentException

Parametr wyrażenia XPath nie jest prawidłowym wyrażeniem XPath.

XPathException

Wyrażenie XPath jest nieprawidłowe.

Uwagi

Wyrażenie XPath jest oceniane w celu uzyskania jednego z następujących typów wyników.

Uwaga

Jeśli funkcja zdefiniowana przez użytkownika z nieprawidłową liczbą argumentów (lub niezaimplementowaną funkcją zdefiniowaną przez użytkownika) jest określona w wyrażeniu XPath, wyjątek występuje tylko w czasie wykonywania. Funkcje zdefiniowane przez użytkownika nie są sprawdzane w czasie kompilacji, a wyjątki wynikające z funkcji zdefiniowanych przez użytkownika występują tylko wtedy, gdy wykonanie ocenia wyrażenie.

Uwaga

Nie można skompilować obiektu XPathExpression z kontekstem niestandardowym w jednym kroku, przekazując element XsltContext, który implementuje IXmlNamespaceResolvermetodę , jako argument do tej metody. Aby użyć elementu XPathExpression z kontekstem niestandardowym, należy wywołać metodę SetContext po skompilowaniu wyrażenia.

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

XPathExpression.Compile Metoda

Definicja

Przeciążenia

Compile(String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Compile(String, IXmlNamespaceResolver)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby