TemplateControl.XPathSelect TemplateControl.XPathSelect TemplateControl.XPathSelect TemplateControl.XPathSelect Method

定義

提供對 XML 架構資料進行的執行階段資料繫結,並傳回可以實作 IEnumerable 介面的節點集合。Provides run-time data binding against XML-based data and returns a node collection that implements the IEnumerable interface.

多載

XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,評估 XPath 資料繫結運算式,並傳回實作 IEnumerable 介面的節點集合。Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the IEnumerable interface.

XPathSelect(String) XPathSelect(String) XPathSelect(String) XPathSelect(String)

評估 XPath 資料繫結運算式,並傳回可以實作 IEnumerable 介面的節點集合。Evaluates an XPath data-binding expression and returns a node collection that implements the IEnumerable interface.

XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver) XPathSelect(String, IXmlNamespaceResolver)

使用命名空間解析所需之指定的前置詞和命名空間對應,評估 XPath 資料繫結運算式,並傳回實作 IEnumerable 介面的節點集合。Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the IEnumerable interface.

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

要評估的 XPath 運算式。The XPath expression to evaluate. 如需詳細資訊,請參閱XPathBinderFor more information, see XPathBinder.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

用來解析命名空間的前置詞和命名空間的對應集合。A set of prefix and namespace mappings used for namespace resolution.

傳回

備註

方法會IXPathNavigable使用XPathBinder.Select 方法呼叫方法,以解析運算式評估時所針對的物件參考。GetDataItem XPathSelectThe XPathSelect method calls the XPathBinder.Select method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

另請參閱

XPathSelect(String) XPathSelect(String) XPathSelect(String) XPathSelect(String)

評估 XPath 資料繫結運算式,並傳回可以實作 IEnumerable 介面的節點集合。Evaluates an XPath data-binding expression and returns a node collection that implements the IEnumerable interface.

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

要評估的 XPath 運算式。The XPath expression to evaluate. 如需詳細資訊,請參閱XPathBinderFor more information, see XPathBinder.

傳回

範例

下列程式碼範例示範如何XPathSelect Repeater在控制項中使用方法。The following code example demonstrates how to use the XPathSelect method in a Repeater control.

<%@ 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 資料。The following test XML data can be used in the preceding code example.

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

備註

方法會IXPathNavigable使用XPathBinder.Select 方法呼叫方法,以解析運算式評估時所針對的物件參考。GetDataItem XPathSelectThe XPathSelect method calls the XPathBinder.Select method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

另請參閱

適用於