BindingSource.List Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

BindingSource.cs

Ottiene l'elenco a cui è associato il connettore.

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

Valore della proprietà

IList

Oggetto IList che rappresenta l'elenco, oppure null se non è presente alcun elenco sottostante associato a questo oggetto BindingSource.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente vengono illustrati i Listmembri , RemoveAte Count . Per eseguire questo esempio, incollare il codice in un modulo contenente un nome , due etichette denominate e label2e un BindingSource pulsante denominato label1button1.BindingSource1 Associare il button1_Click metodo all'evento Click per button1. Gli utenti di Visual Basic dovranno aggiungere un riferimento a 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

Commenti

La BindingSource classe gestisce in modo uniforme diverse origini dati. Idealmente la List proprietà deve essere impostata su un oggetto generale IList. Tuttavia, a volte potrebbe essere necessario eseguire il cast di questa proprietà in un tipo più specifico. Nella tabella seguente viene illustrato il tipo di elenco sottostante, che dipende dal tipo o dal valore dell'origine dati.

Tipo di origine dati	Descrizione elenco sottostante
DataSource e DataMember sono null	Oggetto ArrayList vuoto.
DataSource è null, ma DataMember non è null	Nessuno; un tentativo di ottenere l'oggetto List genererà un ArgumentExceptionoggetto .
Un'istanza Array	Oggetto Array.
Un'istanza IListSource	Valore restituito da una chiamata al GetList metodo di questa IListSource istanza.
Un'istanza IBindingList	Oggetto IBindingList.
Un'istanza IList	Oggetto IList.
IList Istanza non di tipo "T"	Oggetto BindingList<T> con un elemento.
Un'istanza ICustomTypeDescriptor	Oggetto ArrayList con un elemento.
Oggetto IEnumerable.	Oggetto ArrayList con gli elementi copiati.
Tipo Array con DataMember tipo di elemento "T"	Oggetto BindingList<T>.
Oggetto Type che rappresenta un IListSource oggetto o ITypedList	Istanza creata da una chiamata al CreateInstance(Type) metodo della Activator classe. Può essere generata una NotSupportedException classe.
Tipo IList con DataMember tipo di elemento "T" -oppure- Tipo nonIList	Oggetto BindingList<T>.
Tipo ICustomTypeDescriptor	Nessuno; un tentativo di ottenere l'oggetto List genererà un NotSupportedExceptionoggetto .

Se il tipo recuperato è l'interfaccia IList , la raccolta sottostante può essere più complessa, ad esempio una ArrayList classe o DataView .

Vedi anche

• IList
• Item[Int32]