Repeater.DataSourceID プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

ID コントロールがデータ ソースの取得に使用する必要があるデータ ソース コントロールの Repeater プロパティを取得または設定します。

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

プロパティ値

String

データ ソース コントロールの ID プロパティ。

例外

HttpException

次の理由によりデータ ソースを解決できません。

  • プロパティと DataSourceID プロパティの両方に値をDataSource指定します。

  • プロパティで DataSourceID 指定されたデータ ソースがページに見つかりません。

  • プロパティで指定されたデータ ソースは を DataSourceID 実装 IDataSourceしません。

例

次のコード例では、 プロパティをコントロールの DataSourceID プロパティに ID 設定する方法を SqlDataSource 示します。 ページが読み込まれると、 Repeater コントロールはコントロールによって SqlDataSource 指定されたデータ ソースにバインドされ、データがユーザーに表示されます。

<%@ 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>
    <title>Repeater.DataSourceID Property Example</title>
</head>

  <body>
    <form id="Form1" runat="server">
        
      <h3>Repeater.DataSourceID Property Example</h3>
      
      <asp:repeater id="Repeater1"       
        datasourceid="SqlDataSource1"
        runat="server">
        
        <headertemplate>
          <table border="1">
            <tr>
              <td><b>Product ID</b></td>
              <td><b>Product Name</b></td>
            </tr>
        </headertemplate>
          
        <itemtemplate>
          <tr>
            <td> <%# Eval("ProductID") %> </td>
            <td> <%# Eval("ProductName") %> </td>
          </tr>
        </itemtemplate>
          
        <footertemplate>
          </table>
        </footertemplate>
      </asp:repeater>
        
            <asp:sqldatasource id="SqlDataSource1"          
            connectionstring="<%$ ConnectionStrings:NorthWindConnection%>" 
        selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
        runat="server">
      </asp:sqldatasource>
               
    </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>
    <title>Repeater.DataSourceID Property Example</title>
</head>

  <body>
    <form id="Form1" runat="server">
        
      <h3>Repeater.DataSourceID Property Example</h3>
      
      <asp:repeater id="Repeater1"       
        datasourceid="SqlDataSource1"
        runat="server">
        
        <headertemplate>
          <table border="1">
            <tr>
              <td><b>Product ID</b></td>
              <td><b>Product Name</b></td>
            </tr>
        </headertemplate>
          
        <itemtemplate>
          <tr>
            <td> <%# Eval("ProductID") %> </td>
            <td> <%# Eval("ProductName") %> </td>
          </tr>
        </itemtemplate>
          
        <footertemplate>
          </table>
        </footertemplate>
      </asp:repeater>
        
            <asp:sqldatasource id="SqlDataSource1"          
            connectionstring="<%$ ConnectionStrings:NorthWindConnection%>" 
        selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
        runat="server">
      </asp:sqldatasource>
               
    </form>      
  </body>
</html>

注釈

コントロールが DataSourceID データ ソースを ID 取得するために使用するデータ ソース コントロールの プロパティに Repeater アクセスするには、 プロパティを使用します。 プロパティによって参照されるデータ ソース コントロールには、 インターフェイスを DataSourceID 実装する任意のコントロールを IDataSource 指定できます。 データ ソース コントロールは、それを参照するコントロールと Repeater 同じ名前付けコンテナー内、またはコントロールの親コントロール内に存在する Repeater 必要があります。 プロパティの値 DataSourceID を指定すると、コントロールは Repeater 指定したデータ ソース コントロールにバインドされます。 メソッドを明示的に呼び出すコードを記述する DataBind 必要はありません。

または、 プロパティを DataSource 使用して、コントロールにバインドする値のソースを Repeater 指定することもできます。 データ ソースは、インターフェイス (オブジェクトや オブジェクトなどSystem.Data.DataView) または System.Collections.ArrayList インターフェイスをSystem.Collections.IEnumerable実装するコレクションであるIListSource必要があります。 プロパティを DataSource 設定するときは、データ バインディングを実行するコードを記述する必要があります。

プロパティと DataSourceID プロパティの両方にDataSource値が指定されている場合、ASP.NET はデータ ソースを解決できず、System.Web.HttpException例外がスローされます。

このプロパティの値はビュー ステートに格納されます。

適用対象

こちらもご覧ください