BindingSource.List BindingSource.List BindingSource.List BindingSource.List Property

定義

コネクタのバインド先であるリストを取得します。Gets the list that the connector is bound to.

public:
 property System::Collections::IList ^ List { System::Collections::IList ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Collections.IList List { get; }
member this.List : System.Collections.IList
Public ReadOnly Property List As IList

プロパティ値

リストを表す IList。この BindingSource に関連付けられている基底のリストがない場合は nullAn IList that represents the list, or null if there is no underlying list associated with this BindingSource.

次のコード例は、 ListRemoveAt、およびCountの各メンバーを示しています。The following code example demonstrates the List, RemoveAt, and Count members. この例を実行するには、 BindingSourcelabel2というlabel1名前の2つBindingSource1のラベルとというbutton1名前のボタンを含むフォームにコードを貼り付けます。To run this example, paste the code into a form that contains a BindingSource named BindingSource1, two labels named label1 and label2, and a button named button1. メソッドをのbutton1イベントに関連付けます。 Click button1_ClickAssociate the button1_Click method with the Click event for button1. Visual Basic ユーザーは、System. .dll への参照を追加する必要があります。Visual Basic users will need to add a reference to System.Data.dll.

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 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.List.RemoveAt(4);

    // Remove an item directly from the BindingSource. 
    // This is equivalent to the previous line of code.
    BindingSource1.RemoveAt(4);

    // Show the new count.
    label2.Text = "Count after removal: " + BindingSource1.Count.ToString();
}
    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 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.List.RemoveAt(4)

        ' Remove an item directly from the BindingSource. 
        ' This is equivalent to the previous line of code.
        BindingSource1.RemoveAt(4)

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

    End Sub
End Class

注釈

クラスBindingSourceは、異なるデータソースを一様に処理します。The BindingSource class uniformly handles different data sources. 理想的には、 IListプロパティを[全般]に設定する必要があります。ListIdeally the List property should be set to a general IList. ただし、このプロパティをより具体的な型にキャストすることが必要になる場合もあります。However, sometimes it may be necessary to cast this property to a more specific type. 次の表は、基になるリストの種類を示しています。これは、データソースの種類または値によって異なります。The following table shows the underlying list type, which depends on the type or value of the data source.

データ ソースの種類Data source type 基になるリストの説明Underlying list description
DataSourceDataMembernullDataSource and DataMember are null 空の ArrayListAn empty ArrayList.
DataSourcenullですがDataMember 、がではありません。nullDataSource is null, but DataMember is not null 存在を取得Listしようとすると、 ArgumentExceptionがスローされます。None; an attempt to get the List will throw an ArgumentException.
ArrayインスタンスAn Array instance ArrayAn Array.
IListSourceインスタンスAn IListSource instance GetList このIListSourceインスタンスのメソッドの呼び出しからの戻り値。The return value from a call to the GetList method of this IListSource instance.
IBindingListインスタンスAn IBindingList instance IBindingListAn IBindingList.
IListインスタンスAn IList instance IListAn IList.
型 "TIList " のインスタンス以外A non-IList instance of type "T" 1 BindingList<T>つの要素を持つ。A BindingList<T> with one element.
ICustomTypeDescriptorインスタンスAn ICustomTypeDescriptor instance 1 ArrayListつの要素を持つ。An ArrayList with one element.
IEnumerableAn IEnumerable 要素がコピーされた。ArrayListAn ArrayList with the elements copied over.
項目の種類が "T" の型Array DataMemberThe Array type with DataMember of item type "T" BindingList<T>A BindingList<T>.
またはIListSourceを表す。 TypeITypedListA Type that represents an IListSource or ITypedList クラスのメソッドのCreateInstance(Type)呼び出しによって作成されたインスタンス。 ActivatorAn instance created by a call to the CreateInstance(Type) method of the Activator class. がスローされる可能性があります。 NotSupportedExceptionA NotSupportedException may be thrown.
項目の種類が "T" の型IList DataMemberThe IList type with DataMember of item type "T"

または-or-

IListA non-IList type
BindingList<T>A BindingList<T>.
ICustomTypeDescriptorThe ICustomTypeDescriptor type 存在を取得Listしようとすると、 NotSupportedExceptionがスローされます。None; an attempt to get the List will throw an NotSupportedException.

取得される型がIListインターフェイスである場合、 ArrayListまたはDataViewクラスなど、基になるコレクションがより複雑になる可能性があります。If the type retrieved is the IList interface, the underlying collection may be more complex, such as an ArrayList or DataView class.

適用対象

こちらもご覧ください