BindingSource.List Propiedad

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

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.

Atributos

Ejemplos

En el ejemplo de código siguiente Listse RemoveAtmuestran los Count miembros, y.The following code example demonstrates the List, RemoveAt, and Count members. Para ejecutar este ejemplo, pegue el código en un formulario que contenga BindingSource un BindingSource1denominado, dos etiquetas label1 denominadas y label2, y un button1botón denominado.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. Asocie el button1_Click método con el Click evento para button1.Associate the button1_Click method with the Click event for button1. Visual Basic los usuarios tendrán que 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 distintos orígenes de datos.The BindingSource class uniformly handles different data sources. Idealmente, la List propiedad debe establecerse en un 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 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
DataSourcey DataMember sonnullDataSource and DataMember are null Objeto ArrayList vacío.An empty ArrayList.
DataSourcees null, pero DataMember no esnullDataSource is null, but DataMember is not null Ninguna un intento de obtener el List producirá una ArgumentExceptionexcepción.None; an attempt to get the List will throw an ArgumentException.
Una Array instancia deAn Array instance Una clase Array.An Array.
Una IListSource instancia deAn IListSource instance El valor devuelto de una llamada al GetList método de esta IListSource instancia.The return value from a call to the GetList method of this IListSource instance.
Una IBindingList instancia deAn IBindingList instance Una clase IBindingList.An IBindingList.
Una IList instancia deAn IList instance Una clase IList.An IList.
UnaIList instancia que no es de tipo "T"A non-IList instance of type "T" BindingList<T> Con un elemento.A BindingList<T> with one element.
Una ICustomTypeDescriptor instancia deAn ICustomTypeDescriptor instance ArrayList Con un elemento.An ArrayList with one element.
IEnumerable.An IEnumerable ArrayList Con los elementos copiados.An ArrayList with the elements copied over.
Tipo Array conDataMember el tipo de elemento "T"The Array type with DataMember of item type "T" Objeto BindingList<T>.A BindingList<T>.
Que representa un IListSourceo TypeITypedListA Type that represents an IListSource or ITypedList Instancia de creada por una llamada al CreateInstance(Type) método de la Activator clase.An instance created by a call to the CreateInstance(Type) method of the Activator class. Se NotSupportedException puede producir una excepción.A NotSupportedException may be thrown.
Tipo IList conDataMember el tipo de elemento "T"The IList type with DataMember of item type "T"

O bien-or-

UnIList tipo noA non-IList type
Objeto BindingList<T>.A BindingList<T>.
ICustomTypeDescriptor TipoThe ICustomTypeDescriptor type Ninguna un intento de obtener el List producirá una NotSupportedExceptionexcepción.None; an attempt to get the List will throw an NotSupportedException.

Si el tipo recuperado es IList la interfaz, la colección subyacente puede ser más compleja, como una ArrayList clase DataView o.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: