TemplateControl.XPath Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

Предоставляет поддержку для синтаксического анализа и оценки выражений 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 вызывает 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 ссылки на объект, с которым вычисляется выражение.

См. также раздел

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

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 ссылки на объект, с которым вычисляется выражение.

См. также раздел

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

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 ссылки на объект, с которым вычисляется выражение.

См. также раздел

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