BaseDataList.DataSource プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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)]
[System.Web.UI.Themeable(false)]
public virtual object DataSource { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.DataSource : obj with get, set

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.DataSource : obj with get, set

Public Overridable Property DataSource As Object

プロパティ値

Object

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

属性: BindableAttribute ThemeableAttribute

例外

HttpException

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

ArgumentException

データソースの型が無効です。データソースは、null にするか、IEnumerable または IListSource インターフェイスを実装する必要があります。

例

次のコード例では、プロパティを使用 DataSource して、コントロールにバインドするデータソースを指定する方法を DataGrid 示します。

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
     Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
 
  </script>
 
<head runat="server">
    <title>DataGrid Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>DataGrid Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

注釈

プロパティを DataSource 使用して、データリストコントロールにバインドする値のソースを指定します。データソースは、クラスからBaseDataList派生したコントロールにSystem.Collections.IEnumerableバインドするインターフェイス (、System.Collections.ArrayList、、などSystem.Data.DataView) または System.Collections.Generic.List<T>IListSource インターフェイスを実装するコレクションである必要があります。プロパティを設定するときは、データバインディングを DataSource 実行するコードを手動で記述する必要があります。

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

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

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

このプロパティは、テーマまたはスタイルシートテーマによって設定することはできません。詳細については、「テーマとスキン」と「ASP.NET」を参照してくださいThemeableAttribute。

適用対象

BaseDataList.DataSource プロパティ

定義

プロパティ値

例外

例

注釈

適用対象

こちらもご覧ください

フィードバック

その他のリソース