BindingSource.List Eigenschap

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Bron:
BindingSource.cs
Bron:
BindingSource.cs
Bron:
BindingSource.cs
Bron:
BindingSource.cs
Bron:
BindingSource.cs

Hiermee haalt u de lijst op waaraan de connector is gebonden.

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

Waarde van eigenschap

IList

Een IList die de lijst vertegenwoordigt of null als er geen onderliggende lijst aan deze BindingSourcelijst is gekoppeld.

Kenmerken
BrowsableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u de , Listen RemoveAt ledenCount. Als u dit voorbeeld wilt uitvoeren, plakt u de code in een formulier met een BindingSource benoemde BindingSource1naam, twee labels label1 en label2een knop met de naam button1. Koppel de button1_Click methode aan de Click gebeurtenis voor button1. Visual Basic gebruikers een verwijzing naar System.Data.dllmoeten toevoegen.

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

Opmerkingen

De BindingSource klasse verwerkt verschillende gegevensbronnen uniform. In het ideale geval moet de List woning worden ingesteld op een algemeen IList. Soms kan het echter nodig zijn om deze eigenschap naar een specifieker type te casten. In de volgende tabel ziet u het onderliggende lijsttype, dat afhankelijk is van het type of de waarde van de gegevensbron.

Gegevensbrontype Beschrijving van onderliggende lijst
DataSource en DataMember zijn null Een lege ArrayList.
DataSource is null, maar DataMember is niet null Geen; een poging om de List zal een ArgumentException.
Een Array exemplaar Een Array.
Een IListSource exemplaar De retourwaarde van een aanroep naar de GetList methode van dit IListSource exemplaar.
Een IBindingList exemplaar Een IBindingList.
Een IList exemplaar Een IList.
Een niet-exemplaarIList van het type 'T' Een BindingList<T> met één element.
Een ICustomTypeDescriptor exemplaar Een ArrayList met één element.
Een IEnumerable Een ArrayList met de elementen die zijn gekopieerd.
Het Array type met DataMember itemtype 'T' A BindingList<T>.
Een Type die een IListSource of ITypedList Een exemplaar dat is gemaakt door een aanroep naar de CreateInstance(Type) methode van de Activator klasse. Een NotSupportedException kan worden gegooid.
Het IList type met DataMember itemtype 'T'

– of –

Een niet-typeIList		 A BindingList<T>.
Het ICustomTypeDescriptor type Geen; een poging om de List zal een NotSupportedException.

Als het opgehaalde type de IList interface is, kan de onderliggende verzameling complexer zijn, zoals een ArrayList of DataView klasse.

Van toepassing op

Zie ook