Repeater.DataSource プロパティ

定義

リストに読み込むデータを提供するデータ ソースを取得または設定します。

public:
 virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual object DataSource { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.DataSource : obj with get, set
Public Overridable Property DataSource As Object

プロパティ値

Object

このコントロールにデータを提供するために使用する値のコレクションを格納している IEnumerable オブジェクトまたは IListSource オブジェクト。 既定値は null です。

属性

例外

指定された DataSource オブジェクトが、Repeater コントロールでサポートされているデータ ソースではありません。

DataSource プロパティと DataSourceID プロパティの両方に値が指定されているため、データ ソースを解決できません。

次の例では、ページが読み込まれるときにコントロールをRepeater指定DataSourceする方法を示します。

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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 Example</title>
<script runat="server">
       void Page_Load(Object Sender, EventArgs e) {
 
          if (!IsPostBack) {
             ArrayList values = new ArrayList();
 
             values.Add("Apple");
             values.Add("Orange");
             values.Add("Pear");
             values.Add("Banana");
             values.Add("Grape");
 
             // Set the DataSource of the Repeater. 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form id="form1" runat="server">
 
       <b>Repeater1:</b>
       <br />
         
       <asp:Repeater id="Repeater1" runat="server">
             
          <HeaderTemplate>
             <table border="1">
          </HeaderTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <br />
         
    </form>
 </body>
 </html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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 Example</title>
<script runat="server">

        Sub Page_Load(Sender As Object, e As EventArgs)
            
            If Not IsPostBack Then
                Dim values As New ArrayList()
                
                values.Add("Apple")
                values.Add("Orange")
                values.Add("Pear")
                values.Add("Banana")
                values.Add("Grape")
                
                ' Set the DataSource of the Repeater. 
                Repeater1.DataSource = values
                Repeater1.DataBind()
            End If
        End Sub
        
    </script>
 
 </head>
 <body>
 
    <h3>Repeater Example</h3>
 
    <form id="form1" runat="server">
 
       <b>Repeater1:</b>
       <br />
         
       <asp:Repeater id="Repeater1" runat="server">
             
          <HeaderTemplate>
             <table border="1">
          </HeaderTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <br />
         
    </form>
 </body>
 </html>

注釈

このプロパティを使用して、コントロールにデータを設定するデータのソースを Repeater 指定します。 データベースDataSource、配列、System.Collections.ArrayListまたはオブジェクトにアクセスするための任意System.Collections.IEnumerableのコレクションSystem.Data.DataViewIListSource指定できます。 プロパティを DataSource 設定する場合は、データ ソースにバインドするコードを手動で記述する必要があります。

プロパティで指定されたデータ ソースに DataSource 複数のデータ ソースが含まれている場合は、このプロパティを DataMember 使用して、コントロールにバインドする特定のソースを指定します。 たとえば、複数のテーブルがある System.Data.DataSet 場合は、コントロールにバインドするテーブルを指定する必要があります。 データ ソースを指定したら、メソッドを DataBind 使用してデータ ソースをコントロールにバインドします。

または、このプロパティを DataSourceID 使用して、データ ソース コントロールによって表されるデータ ソースに自動的にバインドすることもできます。 プロパティを DataSourceID 設定すると、コントロールは Repeater 指定したデータ ソース コントロールに自動的にバインドされます。 コントロールのプロパティを動的に変更しない限り、メソッドを DataBind 明示的に呼び出すコードを記述する Repeater 必要はありません。

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

適用対象

こちらもご覧ください