XPathExpression.Compile Metode

Definisi

Ruang nama:: System.Xml.XPath

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

Rakitan:: System.Xml.XPath.dll

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengkompilasi ekspresi XPath yang ditentukan dan mengembalikan XPathExpression objek yang mewakili ekspresi XPath.

Overload

Nama	Deskripsi
Compile(String)	Mengkompilasi ekspresi XPath yang ditentukan dan mengembalikan objek yang XPathExpression mewakili ekspresi XPath.
Compile(String, IXmlNamespaceResolver)	Mengkompilasi ekspresi XPath yang ditentukan, dengan IXmlNamespaceResolver objek yang ditentukan untuk resolusi namespace, dan mengembalikan XPathExpression objek yang mewakili ekspresi XPath.

Compile(String)

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Mengkompilasi ekspresi XPath yang ditentukan dan mengembalikan objek yang XPathExpression mewakili ekspresi 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

Parameter

xpath: String

Ekspresi XPath.

Mengembalikan

XPathExpression

Sebuah objekXPathExpression.

Pengecualian

ArgumentException

Parameter ekspresi XPath bukan ekspresi XPath yang valid.

XPathException

Ekspresi XPath tidak valid.

Contoh

Contoh berikut menunjukkan cara menggunakan jenis pengembalian XPath untuk menentukan cara memproses ekspresi XPath. Contoh menggunakan Compile metode untuk mengembalikan objek baru XPathExpression .

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

Contoh mengambil file contosoBooks.xml sebagai 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>

Keterangan

Ekspresi XPath dievaluasi untuk menghasilkan salah satu jenis hasil berikut.

Note

Jika fungsi yang ditentukan pengguna dengan jumlah argumen yang tidak valid (atau fungsi yang ditentukan pengguna yang tidak diimpirkan) ditentukan dalam ekspresi XPath, pengecualian hanya terjadi pada waktu proses. Fungsi yang ditentukan pengguna tidak diperiksa pada waktu kompilasi dan pengecualian yang dihasilkan dari fungsi yang ditentukan pengguna hanya terjadi jika eksekusi mengevaluasi ekspresi.

Lihat juga

XPathResultType

Berlaku untuk

Compile(String, IXmlNamespaceResolver)

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Sumber:: XPathExpr.cs

Mengkompilasi ekspresi XPath yang ditentukan, dengan IXmlNamespaceResolver objek yang ditentukan untuk resolusi namespace, dan mengembalikan XPathExpression objek yang mewakili ekspresi 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

Parameter

xpath: String

Ekspresi XPath.

nsResolver: IXmlNamespaceResolver

Objek yang mengimplementasikan IXmlNamespaceResolver antarmuka untuk resolusi namespace layanan.

Mengembalikan

XPathExpression

Sebuah objekXPathExpression.

Pengecualian

ArgumentException

Parameter ekspresi XPath bukan ekspresi XPath yang valid.

XPathException

Ekspresi XPath tidak valid.

Keterangan

Ekspresi XPath dievaluasi untuk menghasilkan salah satu jenis hasil berikut.

Note

Jika fungsi yang ditentukan pengguna dengan jumlah argumen yang tidak valid (atau fungsi yang ditentukan pengguna yang tidak diimpirkan) ditentukan dalam ekspresi XPath, pengecualian hanya terjadi pada run-time. Fungsi yang ditentukan pengguna tidak diperiksa pada waktu kompilasi dan pengecualian yang dihasilkan dari fungsi yang ditentukan pengguna hanya terjadi jika eksekusi mengevaluasi ekspresi.

Note

Tidak dimungkinkan untuk mengkompilasi XPathExpression dengan konteks kustom dalam satu langkah dengan meneruskan XsltContext, yang mengimplementasikan IXmlNamespaceResolver, sebagai argumen untuk metode ini. Untuk menggunakan XPathExpression dengan konteks kustom, Anda harus memanggil SetContext metode setelah mengkompilasi ekspresi.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?