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

Définition

Obtient la liste à laquelle le connecteur est lié.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

Valeur de propriété

IList qui représente la liste, ou null s'il n'y a aucune liste sous-jacente associée à ce BindingSource.An IList that represents the list, or null if there is no underlying list associated with this BindingSource.

Exemples

L’exemple de code suivant illustre Listles RemoveAtmembres, Count et.The following code example demonstrates the List, RemoveAt, and Count members. Pour exécuter cet exemple, collez le code dans un formulaire qui contient BindingSource un BindingSource1nommé, deux étiquettes label1 nommées et label2, et un button1bouton nommé.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. Associez button1_Click la méthode à Click l’événement button1pour.Associate the button1_Click method with the Click event for button1. Visual Basic utilisateurs devront ajouter une référence à 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

Remarques

La BindingSource classe gère uniformément différentes sources de données.The BindingSource class uniformly handles different data sources. Dans l' List idéal, la propriété doit être définie IListsur un général.Ideally the List property should be set to a general IList. Toutefois, il peut parfois être nécessaire d’effectuer un cast de cette propriété vers un type plus spécifique.However, sometimes it may be necessary to cast this property to a more specific type. Le tableau suivant indique le type de liste sous-jacent, qui dépend du type ou de la valeur de la source de données.The following table shows the underlying list type, which depends on the type or value of the data source.

Type de source de donnéesData source type Description de la liste sous-jacenteUnderlying list description
DataSourceet DataMember sontnullDataSource and DataMember are null Un ArrayList vide.An empty ArrayList.
DataSourceest null, mais DataMember n’est pasnullDataSource is null, but DataMember is not null None une tentative d’accès à List lève un. ArgumentExceptionNone; an attempt to get the List will throw an ArgumentException.
Une Array instanceAn Array instance Élément Array.An Array.
Une IListSource instanceAn IListSource instance Valeur de retour d’un appel à la GetList méthode de cette IListSource instance.The return value from a call to the GetList method of this IListSource instance.
Une IBindingList instanceAn IBindingList instance Élément IBindingList.An IBindingList.
Une IList instanceAn IList instance Élément IList.An IList.
Une non-IList instance de type "T"A non-IList instance of type "T" BindingList<T> Avec un élément.A BindingList<T> with one element.
Une ICustomTypeDescriptor instanceAn ICustomTypeDescriptor instance ArrayList Avec un élément.An ArrayList with one element.
IEnumerable.An IEnumerable ArrayList Avec les éléments copiés.An ArrayList with the elements copied over.
Type Array avecDataMember le type d’élément «T»The Array type with DataMember of item type "T" BindingList<T>A BindingList<T>.
Qui représente un IListSource ou un. TypeITypedListA Type that represents an IListSource or ITypedList Instance créée par un appel à la CreateInstance(Type) méthode de la Activator classe.An instance created by a call to the CreateInstance(Type) method of the Activator class. Une NotSupportedException peut être levée.A NotSupportedException may be thrown.
Type IList avecDataMember le type d’élément «T»The IList type with DataMember of item type "T"

- ou --or-

Non-IList typeA non-IList type
BindingList<T>A BindingList<T>.
Le ICustomTypeDescriptor typeThe ICustomTypeDescriptor type None une tentative d’accès à List lève un. NotSupportedExceptionNone; an attempt to get the List will throw an NotSupportedException.

Si le type récupéré est l' IList interface, la collection sous-jacente peut être plus complexe, telle ArrayList qu' DataView une classe ou.If the type retrieved is the IList interface, the underlying collection may be more complex, such as an ArrayList or DataView class.

S’applique à

Voir aussi