BindingSource.List Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan daftar yang terikat dengan konektor.

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

[System.ComponentModel.Browsable(false)]
public System.Collections.IList List { get; }

[<System.ComponentModel.Browsable(false)>]
member this.List : System.Collections.IList

Public ReadOnly Property List As IList

Nilai Properti

IList

IList Yang mewakili daftar, atau null jika tidak ada daftar yang mendasar yang terkait dengan iniBindingSource.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut menunjukkan Listanggota , , RemoveAtdan Count . Untuk menjalankan contoh ini, tempelkan kode ke dalam formulir yang berisi BindingSource bernama BindingSource1, dua label bernama label1 dan label2, dan tombol bernama button1. Kaitkan button1_Click metode dengan Click peristiwa untuk button1. Pengguna Visual Basic perlu menambahkan referensi ke 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

Keterangan

Kelas BindingSource secara seragam menangani sumber data yang berbeda. Idealnya List properti harus diatur ke umum IList. Namun, terkadang mungkin perlu untuk melemparkan properti ini ke jenis yang lebih spesifik. Tabel berikut ini memperlihatkan tipe daftar yang mendasar, yang bergantung pada jenis atau nilai sumber data.

Tipe sumber data	Deskripsi daftar yang mendasar
DataSource dan DataMember adalah null	ArrayList kosong.
DataSource adalah null, tetapi DataMember tidak null	Tidak; upaya untuk mendapatkan List akan melempar ArgumentException.
Instans Array	Sebuah Array.
Instans IListSource	Nilai yang dikembalikan dari panggilan ke GetList metode instans ini IListSource .
Instans IBindingList	Sebuah IBindingList.
Instans IList	Sebuah IList.
Non-instansIList jenis "T"	A BindingList<T> dengan satu elemen.
Instans ICustomTypeDescriptor	Dengan ArrayList satu elemen.
An IEnumerable	Dengan ArrayList elemen yang disalin.
Jenis Array dengan DataMember jenis item "T"	BindingList<T>.
Type yang mewakili IListSource atauITypedList	Instans yang dibuat oleh panggilan ke CreateInstance(Type) metode Activator kelas . A NotSupportedException mungkin dilemparkan.
Jenis IList dengan DataMember jenis item "T" -atau- Non-jenisIList	BindingList<T>.
Jenis ICustomTypeDescriptor	Tidak; upaya untuk mendapatkan List akan melempar NotSupportedException.

Jika jenis yang diambil adalah IList antarmuka, koleksi yang mendasar mungkin lebih kompleks, seperti ArrayList kelas atau DataView .

Lihat juga

• IList
• Item[Int32]