TemplateControl.XPath 方法

參考

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

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

提供在執行階段時對物件剖析並評估 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

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

例外狀況

InvalidOperationException

資料繫結方法只能用於 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

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

例外狀況

InvalidOperationException

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

備註

方法 XPath 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法，以解析 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 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法，以解析 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 會使用 GetDataItem 方法來呼叫 XPathBinder.Eval 方法，以解析 IXPathNavigable 運算式所評估的物件參考。

另請參閱

適用於

共用方式為

TemplateControl.XPath 方法

定義

多載

XPath(String, String, IXmlNamespaceResolver)

參數

傳回

例外狀況

備註

另請參閱

適用於

XPath(String, IXmlNamespaceResolver)

參數

傳回

例外狀況

備註

另請參閱

適用於

XPath(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

XPath(String, String)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源