DataSource プロパティ (GcListBox)

コントロールのデータソースを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Shadows Property DataSource As Object

public new object DataSource {get; set;}

プロパティ値

既定値：Null

例外

例外	解説
System.InvalidOperationException	DataSourceプロパティとDataSourceIDプロパティの両方にデータソースが設定されています。

解説

リストコントロールに項目を設定するには、Itemsが参照するListItemCollectionオブジェクトに直接アクセスする方法と、DataSource、またはDataSourceIDプロパティを使用する方法の２つがあります。

接続するデータソースに存在するデータフィールドと同数のカラムを自動的に生成するようにするには、AutoGenerateColumnsプロパティをTrueに設定します。コントロールとデータソースをバインドするには、DataSourceプロパティを設定した後、DataBindメソッドを明示的に呼び出す必要があります。

使用例

次のサンプルコードでは、DataSourceプロパティを使用してデータソースに接続する方法を示します。

Visual Basic
C#

Imports System.Data

' 仮想データテーブルを作成します。
Dim dt As DataTable = New DataTable()

dt.Columns.Add("Field1", GetType(String))
dt.Columns.Add("Field2", GetType(String))
dt.Columns.Add("Field3", GetType(String))
dt.Columns.Add("Field4", GetType(String))
dt.Columns.Add("Field5", GetType(String))

Dim dr As DataRow

For i As Integer = 0 To 10
    dr = dt.NewRow()
    dr("Field1") = "Item1_" + i.ToString
    dr("Field2") = "Item2_" + i.ToString
    dr("Field3") = "Item3_" + i.ToString
    dr("Field4") = "Item4_" + i.ToString
    dr("Field5") = "Item5_" + i.ToString
    dt.Rows.Add(dr)
Next

' ヘッダを表示します。
GcListBox1.ListHeaderPane.Visible = True
' 自動的にカラムが生成されるようにします。
GcListBox1.AutoGenerateColumns = True
' データソースに接続し、データバインドします。
GcListBox1.DataSource = dt
GcListBox1.DataBind()

using System.Data;

// 仮想データテーブルを作成します。
DataTable dt = new DataTable();

dt.Columns.Add("Field1", typeof(string));
dt.Columns.Add("Field2", typeof(string));
dt.Columns.Add("Field3", typeof(string));
dt.Columns.Add("Field4", typeof(string));
dt.Columns.Add("Field5", typeof(string));

DataRow dr;

for (int i = 0; i < 10; i++ )
{
    dr = dt.NewRow();
    dr["Field1"] = "Item1_" + i.ToString();
    dr["Field2"] = "Item2_" + i.ToString();
    dr["Field3"] = "Item3_" + i.ToString();
    dr["Field4"] = "Item4_" + i.ToString();
    dr["Field5"] = "Item5_" + i.ToString();
    dt.Rows.Add(dr);
}

// ヘッダを表示します。
GcListBox1.ListHeaderPane.Visible = true;
// 自動的にカラムが生成されるようにします。
GcListBox1.AutoGenerateColumns = true;
// データソースに接続し、データバインドします。
GcListBox1.DataSource = dt;
GcListBox1.DataBind();

参照

GcListBox クラス
 GcListBox メンバ