BindingSource.List Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

BindingSource.cs

Возвращает список, к которому привязан соединитель.

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

Значение свойства

IList

Значение IList , представляющее список или null не связанное с этим BindingSourceбазовым списком.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода показаны элементы и RemoveAtCount членыList. Чтобы запустить этот пример, вставьте код в форму, содержащую BindingSource именованные BindingSource1, две метки label1 и label2кнопку с именем button1. Свяжите button1_Click метод с событием Click для button1. Пользователям Visual Basic потребуется добавить ссылку на 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 равномерно обрабатывает различные источники данных. В идеале List свойство должно иметь общее IListзначение. Однако иногда может потребоваться привести это свойство к более конкретному типу. В следующей таблице показан базовый тип списка, который зависит от типа или значения источника данных.

Тип источника данных	Описание базового списка
DataSource и DataMember являются null	Пустой ArrayList.
DataSource is null, но DataMember не является null	Ни один; попытка получить List вызов .ArgumentException
Экземпляр Array	Объект Array.
Экземпляр IListSource	Возвращаемое значение из вызова GetList метода этого IListSource экземпляра.
Экземпляр IBindingList	Объект IBindingList.
Экземпляр IList	Объект IList.
Не экземплярIList типа "T"	Элемент с одним элементом BindingList<T> .
Экземпляр ICustomTypeDescriptor	Элемент с одним элементом ArrayList .
An IEnumerable	Элемент ArrayList с скопированными элементами.
Array Тип с DataMember типом элемента "T"	А BindingList<T>.
Объект, Type представляющий IListSource или ITypedList	Экземпляр, созданный вызовом CreateInstance(Type) метода Activator класса. NotSupportedException Может быть создано исключение.
IList Тип с DataMember типом элемента "T" –или– Тип, отличныйIList от типа	А BindingList<T>.
Тип ICustomTypeDescriptor.	Ни один; попытка получить List вызов .NotSupportedException

Если полученный тип является интерфейсом IList , базовая коллекция может быть более сложной, например класс ArrayList или DataView класс.

См. также раздел

• IList
• Item[Int32]