XPathExpression.Compile 方法

參考

定義

命名空間:: System.Xml.XPath

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.XPath.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編譯指定的 XPath 運算式，並傳回表示 XPath 運算式的 XPathExpression 物件。

多載

Compile(String)	編譯指定的 XPath 運算式，並傳回代表 XPath運算式的 XPathExpression 物件。
Compile(String, IXmlNamespaceResolver)	以為命名空間解析指定的 IXmlNamespaceResolver 物件，編譯指定的 XPath 運算式，並傳回表示 XPath 運算式的 XPathExpression 物件。

Compile(String)

編譯指定的 XPath 運算式，並傳回代表 XPath運算式的 XPathExpression 物件。

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

參數

xpath: String

XPath 運算式。

傳回

XPathExpression

XPathExpression 物件。

例外狀況

ArgumentException

XPath 運算式參數不是有效的 XPath 運算式。

XPathException

XPath 運算式無效。

範例

下列範例示範如何使用 XPath 傳回類型來判斷如何處理 XPath 運算式。此範例會 Compile 使用方法傳回新的 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

該範例採用 contosoBooks.xml 檔案做為輸入。

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

備註

系統會評估 XPath 運算式，以產生下列其中一個結果類型。

注意

如果在 XPath 運算式中指定了無效數目的引數 (或未實作的使用者定義函數) ，則只會在執行時間發生例外狀況。只有在執行評估運算式時，才會發生使用者定義函式所產生的例外狀況，且不會在編譯時期檢查使用者定義函數。

另請參閱

XPathResultType

適用於

Compile(String, IXmlNamespaceResolver)

以為命名空間解析指定的 IXmlNamespaceResolver 物件，編譯指定的 XPath 運算式，並傳回表示 XPath 運算式的 XPathExpression 物件。

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

參數

xpath: String

XPath 運算式。

nsResolver: IXmlNamespaceResolver

物件，實作命名空間解析的 IXmlNamespaceResolver 介面。

傳回

XPathExpression

XPathExpression 物件。

例外狀況

ArgumentException

XPath 運算式參數不是有效的 XPath 運算式。

XPathException

XPath 運算式無效。

備註

系統會評估 XPath 運算式，以產生下列其中一個結果類型。

注意

如果在 XPath 運算式中指定了無效數目的引數 (或未實作的使用者定義函數) ，則只會在執行時間發生例外狀況。在編譯時期不會檢查使用者定義函數，而且只有在執行評估運算式時，才會發生使用者定義函數所產生的例外狀況。

注意

無法藉由傳遞 XsltContext 實作的， IXmlNamespaceResolver 作為這個方法的引數，在一個步驟中使用自訂內容編譯 XPathExpression 。若要搭配自訂內容使用 XPathExpression ，您必須在編譯運算式之後呼叫 SetContext 方法。

另請參閱

適用於

共用方式為

XPathExpression.Compile 方法

定義

多載

Compile(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Compile(String, IXmlNamespaceResolver)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源