TemplateControl.XPathSelectとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TemplateControl.XPathSelect メソッド (String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

XPath データバインディング式を評価し、IEnumerable インターフェイスを実装するノードコレクションを返します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Function
 XPathSelect ( _
    xPathExpression As String _
) As IEnumerable

Visual Basic (使用法)

Dim xPathExpression As String
Dim returnValue As IEnumerable

returnValue = Me.XPathSelect(xPathExpression)

protected internal IEnumerable XPathSelect (
    string xPathExpression
)

C++

protected public:
IEnumerable^ XPathSelect (
    String^ xPathExpression
)

protected IEnumerable XPathSelect (
    String xPathExpression
)

JScript

protected internal function
 XPathSelect (
    xPathExpression : String
) : IEnumerable

パラメータ

xPathExpression: 評価する XPath 式。詳細については、「XPathBinder」を参照してください。

戻り値
IEnumerable ノードリスト。

解説

XPathSelect メソッドは XPathBinder.Select メソッドを呼び出し、GetDataItem メソッドを使用して、式が評価される対象となる IXPathNavigable オブジェクト参照を解決します。

使用例

Repeater コントロールで XPathSelect メソッドを使用する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

次のサンプル XML データを前のコード例で使用できます。

<contacts>
   <contact>
     <name>contact name 1</name>
     <note>contact note 1</note>
   </contact>
   <contact>
     <name>contact name 2</name>
     <note>contact note 2</note>
   </contact>
</contacts>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TemplateControl クラス
TemplateControl メンバ
System.Web.UI 名前空間
XPathBinder
その他の技術情報
データバインド式構文

TemplateControl.XPathSelect メソッド (String, IXmlNamespaceResolver)