Teilen über


BindingSource.List Eigenschaft

Definition

Ruft die Liste ab, an die die Verbindung gebunden wird.

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

Eigenschaftswert

Eine IList, die die Liste darstellt, oder null, wenn keine zugrunde liegende Liste vorhanden ist, die dieser BindingSource zugeordnet ist.

Attribute

Beispiele

Im folgenden Codebeispiel werden die ListMember , RemoveAtund Count veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Formular ein, das einen BindingSource namens BindingSource1, zwei Bezeichnungen mit dem Namen label1 und label2und eine Schaltfläche mit dem Namen button1enthält. Ordnen Sie die button1_Click -Methode dem Click -Ereignis für button1zu. Visual Basic-Benutzer müssen einen Verweis auf System.Data.dll hinzufügen.

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

Hinweise

Die BindingSource -Klasse behandelt unterschiedliche Datenquellen einheitlich. Im Idealfall sollte die List -Eigenschaft auf einen allgemeinen IListfestgelegt werden. Manchmal kann es jedoch erforderlich sein, diese Eigenschaft in einen spezifischeren Typ zu umwandeln. Die folgende Tabelle zeigt den zugrunde liegenden Listentyp, der vom Typ oder Wert der Datenquelle abhängt.

Datenquellentyp Beschreibung der zugrunde liegenden Liste
DataSource und DataMember sind null Ein leerer ArrayList.
DataSource ist null, aber DataMember nicht null Nichts; Ein Versuch, die abzurufen, List löst eine aus ArgumentException.
Ein Array instance Array.
Ein IListSource instance Der Rückgabewert aus einem Aufruf der GetList -Methode dieses IListSource instance.
Ein IBindingList instance IBindingList.
Ein IList instance IList.
Eine nichtIList instance vom Typ "T" Ein BindingList<T> mit einem Element.
Ein ICustomTypeDescriptor instance Ein ArrayList mit einem Element.
Ein IEnumerable. Ein ArrayList mit kopierten Elementen.
Der Array Typ mit DataMember vom Elementtyp "T" Ein BindingList<T>.
Eine Type , die ein IListSource oder darstellt ITypedList Eine instance, die durch einen Aufruf der CreateInstance(Type) -Methode der Activator -Klasse erstellt wurde. Ein NotSupportedException kann ausgelöst werden.
Der IList Typ mit DataMember vom Elementtyp "T"

- oder -

Ein Nicht-TypIList
Ein BindingList<T>.
Der Typ ICustomTypeDescriptor Nichts; Ein Versuch, die abzurufen, List löst eine aus NotSupportedException.

Wenn der abgerufene Typ die IList -Schnittstelle ist, kann die zugrunde liegende Auflistung komplexer sein, z. B. eine - oder DataView -ArrayListKlasse.

Gilt für:

Weitere Informationen