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)

参数

返回

例外

注解

另请参阅

适用于

其他资源