BindingSource.List Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Bağlayıcının bağlı olduğu listeyi alır.

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

Özellik Değeri

IList

IList Listeyi temsil eden veya null bu BindingSourceile ilişkilendirilmiş bir temel liste yoksa.

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği , RemoveAtve Count üyelerini Listgösterir. Bu örneği çalıştırmak için, kodu adlı bir BindingSource , ve adlı BindingSource1label1 iki etiket ve label2adlı button1bir düğme içeren bir forma yapıştırın. button1_Click yöntemini için button1olayıyla ilişkilendirinClick. Visual Basic kullanıcılarının System.Data.dll bir başvuru eklemesi gerekir.

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

Açıklamalar

BindingSource sınıfı farklı veri kaynaklarını tekdüzen işler. İdeal olarak List özelliği genel IListolarak ayarlanmalıdır. Ancak, bazen bu özelliğin daha belirli bir türe atanması gerekebilir. Aşağıdaki tabloda, veri kaynağının türüne veya değerine bağlı olarak temel alınan liste türü gösterilmektedir.

Veri kaynağı türü	Temel alınan liste açıklaması
DataSourceve DataMembernull	Boş ArrayListbir .
DataSource , nullancak DataMember değildir null	Hiçbiri; alma List girişimi bir ArgumentExceptionoluşturur.
Örnek Array	Bir Array.
Örnek IListSource	Bu IListSource örneğin yöntemine yapılan çağrıdan GetList döndürülen değer.
Örnek IBindingList	Bir IBindingList.
Örnek IList	Bir IList.
"T" türünün örneği olmayanIList bir	Tek öğeli A BindingList<T> .
Örnek ICustomTypeDescriptor	Tek öğeli bir ArrayList .
Bir IEnumerable	Öğelerin üzerine kopyalanmış olduğu bir ArrayList .
Öğe Array türü "T" olan DataMember tür	Bir BindingList<T>.
Bir Type veya'yi temsil eden bir IListSourceITypedList	sınıfının yöntemine CreateInstance(Type)Activator yapılan bir çağrı tarafından oluşturulan örnek. Bir NotSupportedException atılabilir.
Öğe IList türü "T" olan DataMember tür -veya- Tür olmayanIList bir	Bir BindingList<T>.
Türü ICustomTypeDescriptor	Hiçbiri; alma List girişimi bir NotSupportedExceptionoluşturur.

Alınan tür arabirimseIList, temel alınan koleksiyon veya DataView sınıfı gibi ArrayList daha karmaşık olabilir.

Ayrıca bkz.

• IList
• Item[Int32]