乐胖代购免代理版

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

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

Repeater.DataSource プロパティ

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

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

Visual Basic (宣言)

<BindableAttribute(True)> _
Public Overridable Property
 DataSource As Object

Visual Basic (使用法)

Dim instance As Repeater
Dim value As Object

value = instance.DataSource

instance.DataSource = value

[BindableAttribute(true)] 
public virtual Object DataSource { get; set;
 }

C++

[BindableAttribute(true)] 
public:
virtual property Object^ DataSource {
    Object^ get ();
    void set (Object^ value);
}

/** @property */
public Object get_DataSource ()

/** @property */
public void set_DataSource (Object value)

JScript

public function get DataSource
 () : Object

public function set DataSource
 (value : Object)

プロパティ値
このコントロールにデータを提供するために使用する値のコレクションを格納している IEnumerable オブジェクトまたは IListSource オブジェクト。既定値は null 参照 (Visual Basic では Nothing) です。

例外

例外の種類	条件
ArgumentException	指定された DataSource オブジェクトが、Repeater コントロールでサポートされているデータソースではありません。
HttpException	DataSource プロパティと DataSourceID プロパティの両方に値が指定されているため、データソースを解決できません。

解説

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

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

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

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

使用例

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

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
<html>
 <head>
    <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 runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
    <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 runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
             
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>