XPathBinder クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説このクラスのオーバーロードした Eval メソッドを使用して、XmlNode など、IXPathNavigable インターフェイスを実装したオブジェクトに対して実行した XPath 式の結果にバインドできます。Select メソッドを使用して、IXPathNavigable オブジェクトに対して実行した XPath 式の結果をノードの IEnumerable リストとして取得できます。このノードのリストは、直接列挙できますが、Repeater や DataList などのリスト コントロールの DataSource プロパティに代入することもできます。
XPathBinder のメソッドを宣言的に使用すると、簡略化されたデータ バインディング構文を使用できます。XPathBinder.Eval(Container.DataItem, xpath) を呼び出す代わりに、XPath(xpath) を使用できます。同様に、XPathBinder.Select(Container.DataItem,xpath) を呼び出す代わりに、XPathSelect(xpath) を使用して、ノードの IEnumerable セットを取得できます。この簡略化構文を使用する場合、Eval メソッドと Select メソッドでは、既定の Container.DataItem コンテキスト オブジェクトが前提となります。
ASP.NET サーバー コントロールへのデータ バインディングの詳細については、「データ バインド式構文」を参照してください。
使用例テンプレートの Repeater コントロールと共に XmlDataSource コントロールを使用して XML データを表示する方法を次のコード例に示します。この例は、2 つの部分で構成されます。
この例の最初の部分は、XmlDataSource コントロール経由でアクセスされる XML データを表示する Web フォーム ページを示します。Repeater コントロールは、簡略化した Eval(Object,String) メソッド構文を使用して、XmlDataSource が表す XML ドキュメント内のデータ項目にバインドします。これは、Select(Object,String) メソッドを使用して IEnumerable リストを取得し、Repeater コントロールの遅延バインディングされる DataSource プロパティとして代入します。
<%@ Page Language="VB" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <BODY> <form runat="server"> <asp:XmlDataSource runat="server" id="XmlDataSource1" XPath="orders/order" DataFile="order.xml" /> <asp:Repeater ID="Repeater1" runat="server" DataSourceID="XmlDataSource1"> <ItemTemplate> <h2>Order</h2> <table> <tr> <td>Customer</td> <td><%#XPath("customer/@id")%></td> <td><%#XPath("customername/firstn")%></td> <td><%#XPath("customername/lastn")%></td> </tr> <tr> <td>Ship To</td> <td><%#XPath("shipaddress/address1")%></FONT></td> <td><%#XPath("shipaddress/city")%></td> <td><%#XPath("shipaddress/state")%> , <%#XPath("shipaddress/zip")%></td> </tr> </table> <h3>Order Summary</H3> <asp:Repeater ID="Repeater2" DataSource='<%#XPathSelect("summary/item")%>' runat="server"> <ItemTemplate> <b><%#XPath("@dept")%></b> - <%#XPath(".")%><br /> </ItemTemplate> </asp:Repeater> <hr> </ItemTemplate> </asp:Repeater> </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> <BODY> <form runat="server"> <asp:XmlDataSource runat="server" id="XmlDataSource1" XPath="orders/order" DataFile="order.xml" /> <asp:Repeater ID="Repeater1" runat="server" DataSourceID="XmlDataSource1"> <ItemTemplate> <h2>Order</h2> <table> <tr> <td>Customer</td> <td><%#XPath("customer/@id")%></td> <td><%#XPath("customername/firstn")%></td> <td><%#XPath("customername/lastn")%></td> </tr> <tr> <td>Ship To</td> <td><%#XPath("shipaddress/address1")%></FONT></td> <td><%#XPath("shipaddress/city")%></td> <td><%#XPath("shipaddress/state")%>, <%#XPath("shipaddress/zip")%></td> </tr> </table> <h3>Order Summary</H3> <asp:Repeater ID="Repeater2" DataSource='<%#XPathSelect("summary/item")%>' runat="server"> <ItemTemplate> <b><%#XPath("@dept")%></b> - <%#XPath(".")%><br /> </ItemTemplate> </asp:Repeater> <hr> </ItemTemplate> </asp:Repeater> </form> </BODY> </HTML>
<%@ Page Language="VJ#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <BODY> <asp:XmlDataSource runat="server" id="XmlDataSource1" XPath="orders/order" DataFile="order.xml" /> <asp:Repeater ID="Repeater1" runat="server" DataSourceID="XmlDataSource1"> <ItemTemplate> <h2>Order</h2> <table> <tr> <td>Customer</td> <td><%#XPath("customer/@id")%></td> <td><%#XPath("customername/firstn")%></td> <td><%#XPath("customername/lastn")%></td> </tr> <tr> <td>Ship To</td> <td><%#XPath("shipaddress/address1")%></FONT></td> <td><%#XPath("shipaddress/city")%></td> <td><%#XPath("shipaddress/state")%>, <%#XPath("shipaddress/zip")%></td> </tr> </table> <h3>Order Summary</H3> <asp:Repeater ID="Repeater2" DataSource='<%#XPathSelect("summary/item")%>' runat="server"> <ItemTemplate> <b><%#XPath("@dept")%></b> - <%#XPath(".")%><br /> </ItemTemplate> </asp:Repeater> <hr> </ItemTemplate> </asp:Repeater> </form> </BODY> </HTML>
2 番目の例では、Order.xml という XML ファイルを示しています。これは、上記で定義した Web フォーム ページに表示されるデータのソースとして使用されます。
<?xml version="1.0" encoding="iso-8859-1"?> <orders> <order> <customer /> <customername> <firstn>John</firstn> <lastn>Doe</lastn> </customername> <transaction /> <shipaddress> <address1>1234 Tenth Avenue</address1> <city>Bellevue</city> <state>Washington</state> <zip>98001</zip> </shipaddress> <summary> <item dept="tools">screwdriver</item> <item dept="tools">hammer</item> <item dept="plumbing">fixture</item> </summary> </order> </orders>
.NET Framework のセキュリティ継承階層System.Web.UI.XPathBinder
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照XPathBinder メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
.gif) | Eval | オーバーロードされます。 実行時に IXPathNavigable オブジェクトに対して XPath データ バインド式を解析および評価します。 |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | Select | オーバーロードされます。 実行時に XPath データ バインド式を使用してノードのリストを返します。 |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照XPathBinder メンバ
RAD (Rapid Application Development) デザイナで、XPath 式を使用したデータ バインド式を解析できるようにします。このクラスは継承できません。
XPathBinder データ型で公開されるメンバを以下の表に示します。
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | Eval | オーバーロードされます。 実行時に IXPathNavigable オブジェクトに対して XPath データ バインド式を解析および評価します。 |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | Select | オーバーロードされます。 実行時に XPath データ バインド式を使用してノードのリストを返します。 |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- XPathBinderのページへのリンク
