TemplateControl.XPath 方法

定義

提供在執行階段時對物件剖析並評估 XPath 資料繫結運算式的支援。

多載

XPath(String, String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,以及指定的格式字串,評估 XPath 資料繫結運算式以顯示結果。

XPath(String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,評估 XPath 資料繫結運算式。

XPath(String)

評估 XPath 資料繫結運算式。

XPath(String, String)

使用指定的格式字串評估 XPath 資料繫結運算式以顯示結果。

XPath(String, String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,以及指定的格式字串,評估 XPath 資料繫結運算式以顯示結果。

protected public:
 System::String ^ XPath(System::String ^ xPathExpression, System::String ^ format, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal string XPath (string xPathExpression, string format, System.Xml.IXmlNamespaceResolver resolver);
member this.XPath : string * string * System.Xml.IXmlNamespaceResolver -> string
Protected Friend Function XPath (xPathExpression As String, format As String, resolver As IXmlNamespaceResolver) As String

參數

xPathExpression
String

要評估的 XPath 運算式。 如需詳細資訊,請參閱XPathBinder

format
String

要套用到結果的 .NET Framework 格式字串。

resolver
IXmlNamespaceResolver

用來解析命名空間的前置詞和命名空間的對應集合。

傳回

String

從資料繫結運算式評估和字串型別轉換所產生的字串。

例外狀況

資料繫結方法只能用於 Page 包含的控制項。

備註

方法 XPath 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法,以解析 IXPathNavigable 運算式所評估的物件參考。

另請參閱

適用於

XPath(String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,評估 XPath 資料繫結運算式。

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal object XPath (string xPathExpression, System.Xml.IXmlNamespaceResolver resolver);
member this.XPath : string * System.Xml.IXmlNamespaceResolver -> obj
Protected Friend Function XPath (xPathExpression As String, resolver As IXmlNamespaceResolver) As Object

參數

xPathExpression
String

要評估的 XPath 運算式。 如需詳細資訊,請參閱XPathBinder

resolver
IXmlNamespaceResolver

用來解析命名空間的前置詞和命名空間的對應集合。

傳回

Object

從資料繫結運算式的評估產生的物件。

例外狀況

資料繫結方法只能用於 Page 包含的控制項。

備註

方法 XPath 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法,以解析 IXPathNavigable 運算式所評估的物件參考。

另請參閱

適用於

XPath(String)

評估 XPath 資料繫結運算式。

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression);
protected internal object XPath (string xPathExpression);
member this.XPath : string -> obj
Protected Friend Function XPath (xPathExpression As String) As Object

參數

xPathExpression
String

要評估的 XPath 運算式。 如需詳細資訊,請參閱XPathBinder

傳回

Object

從資料繫結運算式的評估產生的物件。

例外狀況

資料繫結方法只能用於 Page 包含的控制項。

範例

下列程式碼範例示範如何在 控制項中使用 XPath Repeater 方法。

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>TemplateControl XPath and XPathSelect Example</title>
</head>
<body>
    <h3>TemplateControl XPath Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>TemplateControl XPath Example</title>
</head>
<body>
    <h3>TemplateControl XPath and XPathSelect Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </form>
</body>
</html>

下列測試 XML 資料可用於上述程式碼範例中。

<contacts>  
   <contact id="1">  
     <name>contact name 1</name>  
     <note>contact note 1</note>  
   </contact>  
   <contact id="2">  
     <name>contact name 2</name>  
     <note>contact note 2</note>  
   </contact>  
</contacts>  

備註

方法 XPath 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法,以解析 IXPathNavigable 運算式所評估的物件參考。

另請參閱

適用於

XPath(String, String)

使用指定的格式字串評估 XPath 資料繫結運算式以顯示結果。

protected public:
 System::String ^ XPath(System::String ^ xPathExpression, System::String ^ format);
protected internal string XPath (string xPathExpression, string format);
member this.XPath : string * string -> string
Protected Friend Function XPath (xPathExpression As String, format As String) As String

參數

xPathExpression
String

要評估的 XPath 運算式。 如需詳細資訊,請參閱XPathBinder

format
String

要套用到結果的 .NET Framework 格式字串。

傳回

String

從資料繫結運算式評估和字串型別轉換所產生的字串。

例外狀況

資料繫結方法只能用於 Page 包含的控制項。

備註

方法 XPath 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法,以解析 IXPathNavigable 運算式所評估的物件參考。

另請參閱

適用於