TemplateControl.XPath TemplateControl.XPath TemplateControl.XPath TemplateControl.XPath Method

Определение

Предоставляет поддержку для синтаксического анализа и оценки выражений XPath привязки данных с объектом во время выполнения.Provides support for parsing and evaluating an XPath data-binding expression against an object at run time.

Перегрузки

XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver)

Оценивает XPath-выражения привязки данных при помощи префикса и сопоставлений пространства имен для разрешения пространства имен выделенного формата строки для отображение результата.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver)

Оценка выражения привязки данных в формате XPath с использованием указанного префикса и сопоставления пространства имен для разрешения пространства имен.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

XPath(String) XPath(String) XPath(String) XPath(String)

Оценка выражений привязки данных в формате XPath.Evaluates an XPath data-binding expression.

XPath(String, String) XPath(String, String) XPath(String, String) XPath(String, String)

Оценка выражения привязки данных в формате XPath с использованием указанной строки форматирования для отображения результата.Evaluates an XPath data-binding expression using the specified format string to display the result.

XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver)

Оценивает XPath-выражения привязки данных при помощи префикса и сопоставлений пространства имен для разрешения пространства имен выделенного формата строки для отображение результата.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

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

Выражение XPath для оценки.The XPath expression to evaluate. Для получения дополнительной информации см. XPathBinder.For more information, see XPathBinder.

format
String String String String

Строка формата .NET Framework для применения к результату.A .NET Framework format string to apply to the result.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Набор префикса и сопоставления пространства имен, используемый для разрешения пространства имен.A set of prefix and namespace mappings used for namespace resolution.

Возвраты

Строка, являющаяся результатом обработки выражений привязки данных и преобразования в строковый тип.A string that results from the evaluation of the data-binding expression and conversion to a string type.

Исключения

Метод привязки данных используется только для элементов управления в Page.The data-binding method can be used only for controls contained on a Page.

Комментарии

Метод вызывает метод, используя GetDataItem метод для разрешения IXPathNavigable ссылки на объект, для которой вычисляется выражение. XPathBinder.Eval XPathThe XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Дополнительно

XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver)

Оценка выражения привязки данных в формате XPath с использованием указанного префикса и сопоставления пространства имен для разрешения пространства имен.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

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

Выражение XPath для оценки.The XPath expression to evaluate. Для получения дополнительной информации см. XPathBinder.For more information, see XPathBinder.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Набор префикса и сопоставления пространства имен, используемый для разрешения пространства имен.A set of prefix and namespace mappings used for namespace resolution.

Возвраты

Объект, являющийся результатом обработки выражений привязки данных.An object that results from the evaluation of the data-binding expression.

Исключения

Метод привязки данных используется только для элементов управления в Page.The data-binding method can be used only for controls contained on a Page.

Комментарии

Метод вызывает метод, используя GetDataItem метод для разрешения IXPathNavigable ссылки на объект, для которой вычисляется выражение. XPathBinder.Eval XPathThe XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Дополнительно

XPath(String) XPath(String) XPath(String) XPath(String)

Оценка выражений привязки данных в формате XPath.Evaluates an XPath data-binding expression.

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

Выражение XPath для оценки.The XPath expression to evaluate. Для получения дополнительной информации см. XPathBinder.For more information, see XPathBinder.

Возвраты

Объект, являющийся результатом обработки выражений привязки данных.An object that results from the evaluation of the data-binding expression.

Исключения

Метод привязки данных используется только для элементов управления в Page.The data-binding method can be used only for controls contained on a Page.

Примеры

В следующем примере кода показано, как использовать XPath метод Repeater в элементе управления.The following code example demonstrates how to use the XPath 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>  

Комментарии

Метод вызывает метод, используя GetDataItem метод для разрешения IXPathNavigable ссылки на объект, для которой вычисляется выражение. XPathBinder.Eval XPathThe XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Дополнительно

XPath(String, String) XPath(String, String) XPath(String, String) XPath(String, String)

Оценка выражения привязки данных в формате XPath с использованием указанной строки форматирования для отображения результата.Evaluates an XPath data-binding expression using the specified format string to display the result.

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

Выражение XPath для оценки.The XPath expression to evaluate. Для получения дополнительной информации см. XPathBinder.For more information, see XPathBinder.

format
String String String String

Строка формата .NET Framework для применения к результату.A .NET Framework format string to apply to the result.

Возвраты

Строка, являющаяся результатом обработки выражений привязки данных и преобразования в строковый тип.A string that results from the evaluation of the data-binding expression and conversion to a string type.

Исключения

Метод привязки данных используется только для элементов управления в Page.The data-binding method can be used only for controls contained on a Page.

Комментарии

Метод вызывает метод, используя GetDataItem метод для разрешения IXPathNavigable ссылки на объект, для которой вычисляется выражение. XPathBinder.Eval XPathThe XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Дополнительно

Применяется к