BindingSource.List BindingSource.List BindingSource.List BindingSource.List Property

Definición

Obtiene la lista a la que está enlazada el conector.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

Valor de propiedad

Un IList que representa la lista, o null si no hay ninguna lista subyacente asociada a este BindingSource.An IList that represents the list, or null if there is no underlying list associated with this BindingSource.

Ejemplos

En el ejemplo de código siguiente se muestra el List, RemoveAt, y Count miembros.The following code example demonstrates the List, RemoveAt, and Count members. Para ejecutar este ejemplo, pegue el código en un formulario que contenga un BindingSource denominado BindingSource1, dos etiquetas denominadas label1 y label2y un botón denominado button1.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. Asociar el button1_Click método con el Click eventos para button1.Associate the button1_Click method with the Click event for button1. Los usuarios de Visual Basic deberá agregar una referencia a System.Data.dll.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

Comentarios

La BindingSource clase controla uniformemente los distintos orígenes de datos.The BindingSource class uniformly handles different data sources. Lo ideal es que el List propiedad debe establecerse en general IList.Ideally the List property should be set to a general IList. Sin embargo, a veces puede ser necesario convertir esta propiedad en un tipo más específico.However, sometimes it may be necessary to cast this property to a more specific type. En la tabla siguiente se muestra el tipo de lista subyacente, que depende del tipo o el valor del origen de datos.The following table shows the underlying list type, which depends on the type or value of the data source.

Tipo de origen de datosData source type Descripción de la lista subyacenteUnderlying list description
DataSource y DataMember son nullDataSource and DataMember are null Objeto ArrayList vacío.An empty ArrayList.
DataSource es null, pero DataMember no es nullDataSource is null, but DataMember is not null Ninguno; un intento de obtener el List producirá una ArgumentException.None; an attempt to get the List will throw an ArgumentException.
Un Array instanciaAn Array instance Una clase Array.An Array.
Un IListSource instanciaAn IListSource instance El valor devuelto de una llamada a la GetList método esto IListSource instancia.The return value from a call to the GetList method of this IListSource instance.
Un IBindingList instanciaAn IBindingList instance Una clase IBindingList.An IBindingList.
Un IList instanciaAn IList instance Una clase IList.An IList.
NoIList instancia del tipo "T"A non-IList instance of type "T" Un BindingList<T> con un elemento.A BindingList<T> with one element.
Un ICustomTypeDescriptor instanciaAn ICustomTypeDescriptor instance Un ArrayList con un elemento.An ArrayList with one element.
Una IEnumerableAn IEnumerable Un ArrayList con los elementos que se copian.An ArrayList with the elements copied over.
El Array escriba con DataMember del elemento de tipo "T"The Array type with DataMember of item type "T" Objeto BindingList<T>.A BindingList<T>.
Un Type que representa un IListSource o ITypedListA Type that represents an IListSource or ITypedList Una instancia creada por una llamada a la CreateInstance(Type) método de la Activator clase.An instance created by a call to the CreateInstance(Type) method of the Activator class. Un NotSupportedException se puede producir.A NotSupportedException may be thrown.
El IList escriba con DataMember del elemento de tipo "T"The IList type with DataMember of item type "T"

-o bien--or-

NoIList tipoA non-IList type
Objeto BindingList<T>.A BindingList<T>.
El ICustomTypeDescriptor tipoThe ICustomTypeDescriptor type Ninguno; un intento de obtener el List producirá una NotSupportedException.None; an attempt to get the List will throw an NotSupportedException.

Si recupera el tipo es el IList interfaz, la colección subyacente puede ser más compleja, como un ArrayList o DataView clase.If the type retrieved is the IList interface, the underlying collection may be more complex, such as an ArrayList or DataView class.

Se aplica a

Consulte también: