BindingSource.List プロパティとは何？わかりやすく解説 Weblio辞書

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

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

BindingSource.List プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コネクタのバインド先であるリストを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 List As IList

Visual Basic (使用法)

Dim instance As BindingSource
Dim value As IList

value = instance.List

public IList List { get; }

C++

public:
property IList^ List {
    IList^ get ();
}

/** @property */
public IList get_List ()

JScript

public function get List
 () : IList

プロパティ値
リストを表す IList。この BindingSource に関連付けられている基底のリストがない場合は null 参照 (Visual Basic では Nothing)。

解説

BindingSource クラスは、さまざまなデータソースを同じ方法で処理します。List プロパティには、一般的な IList を設定するのが理想的です。しかし、このプロパティをより特殊な型にキャストする必要がある場合があります。次の表では、データソースの型または値に応じた基底のリストの型を示します。

データソースの型	基底のリストに関する説明
DataSource と DataMember が null 参照 (Visual Basic では Nothing) です。	空の ArrayList。
DataSource が null 参照 (Visual Basic では Nothing) ですが、DataMember が null 参照 (Visual Basic では Nothing) ではありません。	なし。List を取得しようとすると ArgumentException がスローされます。
Array のインスタンス。	Array。
IListSource のインスタンス。	IListSource のこのインスタンスの GetList メソッドへの呼び出しによって返される値。
IBindingList のインスタンス。	IBindingList。
IList のインスタンス。	IList。
"T" 型の IList 以外のインスタンス。	1 つの要素を持つ BindingList。
ICustomTypeDescriptor のインスタンス。	1 つの要素を持つ ArrayList。
IEnumerable。	コピーで上書きされる要素を持つ ArrayList。
"T" 型の項目 DataMember を持つ Array 型。	BindingList。
IListSource または ITypedList を表す Type。	Activator クラスの CreateInstance メソッドへの呼び出しによって作成されるインスタンス。NotSupportedException がスローされる場合があります。
"T" 型の項目 DataMember を持つ IList 型。または IList 以外の型。	BindingList。
ICustomTypeDescriptor 型。	なし。List を取得しようとすると NotSupportedException がスローされます。

取得した型が IList インターフェイスである場合、基底のコレクションは、ArrayList クラスや DataView クラスなどより複雑な型になります。

使用例

List、RemoveAt、および Count の各メンバのコード例を次に示します。この例を実行するには、BindingSource1 という名前の BindingSource を持ち、label1 と label2 という名前の 2 つのラベル、および button1 という名前のボタンが配置されているフォームにコードを貼り付けます。次に、button1_Click メソッドを button1 の Click イベントに関連付けます。Visual Basic を使用する場合、System.Data.dll への参照を追加する必要があります。

Visual Basic

    Private Sub button1_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) _
        Handles button1.Click

        ' Create the connection string, data adapter and data table.
        Dim connectionString As New
 SqlConnection("Initial Catalog=Northwind;" &
 _
            "Data Source=localhost;Integrated Security=SSPI;")
        Dim customersTableAdapter As New
 SqlDataAdapter("Select * from Customers", _
            connectionString)
        Dim customerTable As New
 DataTable()

        ' Fill the the adapter with the contents of the customer table.
        customersTableAdapter.Fill(customerTable)

        ' Set data source for BindingSource1.
        BindingSource1.DataSource = customerTable

        ' Set the label text to the number of items in the collection
 before
        ' an item is removed.
        label1.Text = "Starting count: " + BindingSource1.Count.ToString()

        'Access the List property and remove an item.
        BindingSource1.RemoveAt(4)

        ' Show the new count.
        label2.Text = "Count after removal: " + BindingSource1.Count.ToString()

    End Sub
End Class

private void button1_Click(object sender, EventArgs
 e)
{
    // Create the connection string, data adapter and data table.
    SqlConnection connectionString =
         new SqlConnection("Initial Catalog=Northwind;"
 +
         "Data Source=localhost;Integrated Security=SSPI;");
    SqlDataAdapter customersTableAdapter =
        new SqlDataAdapter("Select * from Customers",
 connectionString);
    DataTable customerTable = new DataTable();

    // Fill the the adapter with the contents of the customer table.
    customersTableAdapter.Fill(customerTable);

    // Set data source for BindingSource1.
    BindingSource1.DataSource = customerTable;

    // Set the label text to the number of items in the collection before
    // an item is removed.
    label1.Text = "Starting count: " + BindingSource1.Count.ToString();

    //Access the List property and remove an item.
    BindingSource1.RemoveAt(4);

    // Show the new count.
    label2.Text = "Count after removal: " + BindingSource1.Count.ToString();
}