BindingSource.List Eigenschaft

Definition

Ruft die Liste ab, an die die Verbindung gebunden wird.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

Eigenschaftswert

Eine IList, die die Liste darstellt, oder null, wenn keine zugrunde liegende Liste vorhanden ist, die dieser BindingSource zugeordnet ist.An IList that represents the list, or null if there is no underlying list associated with this BindingSource.

Attribute

Beispiele

Im folgenden Codebeispiel werden die Elemente List, RemoveAtund Count veranschaulicht.The following code example demonstrates the List, RemoveAt, and Count members. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Formular ein, das eine BindingSource mit dem Namen BindingSource1, zwei Bezeichnungen namens label1 und label2und eine Schaltfläche mit dem Namen button1enthält.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. Ordnen Sie die button1_Click-Methode dem Click-Ereignis für button1zu.Associate the button1_Click method with the Click event for button1. Visual Basic Benutzer müssen einen Verweis auf "System. Data. dll" hinzufügen.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

Hinweise

Die BindingSource-Klasse verarbeitet einheitlich verschiedene Datenquellen.The BindingSource class uniformly handles different data sources. Im Idealfall sollte die List-Eigenschaft auf einen allgemeinen IListfestgelegt werden.Ideally the List property should be set to a general IList. Manchmal kann es jedoch erforderlich sein, diese Eigenschaft in einen spezifischeren Typ umzuwandeln.However, sometimes it may be necessary to cast this property to a more specific type. In der folgenden Tabelle wird der zugrunde liegende Listentyp angezeigt, der vom Typ oder Wert der Datenquelle abhängig ist.The following table shows the underlying list type, which depends on the type or value of the data source.

DatenquellentypData source type Zugrunde liegende Listen BeschreibungUnderlying list description
DataSource und DataMember sind nullDataSource and DataMember are null Ein leerer ArrayList.An empty ArrayList.
DataSource ist null, aber DataMember nicht nullDataSource is null, but DataMember is not null Gar Wenn Sie versuchen, die List zu erhalten, wird ein ArgumentExceptionausgelöst.None; an attempt to get the List will throw an ArgumentException.
Eine Array-InstanzAn Array instance Ein Array.An Array.
Eine IListSource-InstanzAn IListSource instance Der Rückgabewert eines Aufrufes der GetList-Methode dieser IListSource Instanz.The return value from a call to the GetList method of this IListSource instance.
Eine IBindingList-InstanzAn IBindingList instance Ein IBindingList.An IBindingList.
Eine IList-InstanzAn IList instance Ein IList.An IList.
Eine nichtIList Instanz vom Typ "t".A non-IList instance of type "T" Eine BindingList<T> mit einem Element.A BindingList<T> with one element.
Eine ICustomTypeDescriptor-InstanzAn ICustomTypeDescriptor instance Ein-ArrayList mit einem-Element.An ArrayList with one element.
Ein IEnumerable.An IEnumerable Eine ArrayList, bei der die Elemente kopiert wurden.An ArrayList with the elements copied over.
Der Array Typ mit DataMember des Elementtyps "t".The Array type with DataMember of item type "T" Ein BindingList<T>.A BindingList<T>.
Eine Type, die einen IListSource oder ITypedList darstellt.A Type that represents an IListSource or ITypedList Eine-Instanz, die durch einen aufzurufenden CreateInstance(Type)-Methode der Activator-Klasse erstellt wird.An instance created by a call to the CreateInstance(Type) method of the Activator class. Eine NotSupportedException kann ausgelöst werden.A NotSupportedException may be thrown.
Der IList Typ mit DataMember des Elementtyps "t".The IList type with DataMember of item type "T"

- oder --or-

Ein nichtIList Typ.A non-IList type
Ein BindingList<T>.A BindingList<T>.
Der ICustomTypeDescriptor Typ.The ICustomTypeDescriptor type Gar Wenn Sie versuchen, die List zu erhalten, wird ein NotSupportedExceptionausgelöst.None; an attempt to get the List will throw an NotSupportedException.

Wenn es sich bei dem abgerufenen Typ um die IList-Schnittstelle handelt, kann die zugrunde liegende Auflistung komplexer sein, z. b. eine ArrayList oder DataView Klasse.If the type retrieved is the IList interface, the underlying collection may be more complex, such as an ArrayList or DataView class.

Gilt für:

Siehe auch