Repeater.DataSource プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
リストに読み込むデータを提供するデータ ソースを取得または設定します。
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, setPublic Overridable Property DataSource As 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.DataViewをIListSource指定できます。 プロパティを DataSource 設定する場合は、データ ソースにバインドするコードを手動で記述する必要があります。
プロパティで指定されたデータ ソースに DataSource 複数のデータ ソースが含まれている場合は、このプロパティを DataMember 使用して、コントロールにバインドする特定のソースを指定します。 たとえば、複数のテーブルがある System.Data.DataSet 場合は、コントロールにバインドするテーブルを指定する必要があります。 データ ソースを指定したら、メソッドを DataBind 使用してデータ ソースをコントロールにバインドします。
または、このプロパティを DataSourceID 使用して、データ ソース コントロールによって表されるデータ ソースに自動的にバインドすることもできます。 プロパティを DataSourceID 設定すると、コントロールは Repeater 指定したデータ ソース コントロールに自動的にバインドされます。 コントロールのプロパティを動的に変更しない限り、メソッドを DataBind 明示的に呼び出すコードを記述する Repeater 必要はありません。
プロパティとDataSourceIDプロパティの両方に値がDataSource指定されている場合、ASP.NET はデータ ソースを解決できず、a System.Web.HttpException がスローされます。