TemplateControl.XPathSelect 方法

定義

提供執行時的資料綁定,針對基於 XML 的資料,並回傳實作介面的 IEnumerable 節點集合。

多載

名稱 Description
XPathSelect(String, IXmlNamespaceResolver)

利用指定的前綴與命名空間映射評估 XPath 資料綁定表達式以解析命名空間,並回傳實作介面的 IEnumerable 節點集合。

XPathSelect(String)

評估 XPath 資料綁定表達式,並回傳實作 IEnumerable 介面的節點集合。

XPathSelect(String, IXmlNamespaceResolver)

利用指定的前綴與命名空間映射評估 XPath 資料綁定表達式以解析命名空間,並回傳實作介面的 IEnumerable 節點集合。

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

參數

xPathExpression
String

用來評估的 XPath 表達式。 如需詳細資訊,請參閱XPathBinder

resolver
IXmlNamespaceResolver

一組用於命名空間解析的前綴與命名空間映射。

傳回

一個 IEnumerable 節點清單。

備註

XPathSelect 方法呼叫 XPathBinder.Select 該方法,用 GetDataItem 該方法解析 IXPathNavigable 該表達式所對應的物件參考。

另請參閱

適用於

XPathSelect(String)

評估 XPath 資料綁定表達式,並回傳實作 IEnumerable 介面的節點集合。

protected public:
 System::Collections::IEnumerable ^ XPathSelect(System::String ^ xPathExpression);
protected internal System.Collections.IEnumerable XPathSelect(string xPathExpression);
member this.XPathSelect : string -> System.Collections.IEnumerable
Protected Friend Function XPathSelect (xPathExpression As String) As IEnumerable

參數

xPathExpression
String

用來評估的 XPath 表達式。 如需詳細資訊,請參閱XPathBinder

傳回

一個 IEnumerable 節點清單。

範例

以下程式碼範例示範如何在控制中使用此 XPathSelect 方法 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>

備註

XPathSelect 方法呼叫 XPathBinder.Select 該方法,用 GetDataItem 該方法解析 IXPathNavigable 該表達式所對應的物件參考。

另請參閱

適用於