TemplateControl.XPath 方法

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

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

提供在執行時對物件解析與評估 XPath 資料綁定表達式的支援。

多載

名稱	Description
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

一個由資料綁定表達式的評估及轉換為字串型別所產生的字串。

例外狀況

InvalidOperationException

資料綁定方法僅可用於包含在 Page的控制項。

備註

該 XPath 方法呼叫 XPathBinder.Eval 該方法，用 GetDataItem 該方法解析 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

一個由資料綁定表達式的評估所產生的物件。

例外狀況

InvalidOperationException

資料綁定方法僅可用於包含在 Page的控制項。

備註

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

另請參閱

XPathBinder

適用於

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

一個由資料綁定表達式的評估所產生的物件。

例外狀況

InvalidOperationException

資料綁定方法僅可用於包含在 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 方法呼叫 XPathBinder.Eval 該方法，用 GetDataItem 該方法解析 IXPathNavigable 該表達式所對應的物件參考。

另請參閱

XPathBinder

適用於

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

一個由資料綁定表達式的評估及轉換為字串型別所產生的字串。

例外狀況

InvalidOperationException

資料綁定方法僅可用於包含在 Page的控制項。

備註

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

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？