BindingSource.List Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

IList

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

Attribute: BrowsableAttribute

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:

Freigeben über