BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource Property

Définition

Obtient ou définit la source de données à laquelle le connecteur effectue une liaison.Gets or sets the data source that the connector binds to.

public:
 property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
public object DataSource { get; set; }
member this.DataSource : obj with get, set
Public Property DataSource As Object

Valeur de propriété

Object qui agit comme une source de données.An Object that acts as a data source. La valeur par défaut est null.The default is null.

Exemples

L’exemple de code suivant affecte une liste de clients au DataSource d’un BindingSource composant.The following code example assigns a list of customers to the DataSource of a BindingSource component. Cet exemple de code fait partie d’un exemple plus complet fourni dans How to: Déclenchez des notifications de modifications àl’aide de la méthode ResetItem BindingSource.This code example is part of a larger example provided at How to: Raise Change Notifications Using the BindingSource ResetItem Method.

void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Create and populate the list of DemoCustomer objects
   // which will supply data to the DataGridView.
   List< DemoCustomer^ >^ customerList = gcnew List< DemoCustomer^ >;
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   
   // Bind the list to the BindingSource.
   this->customersBindingSource->DataSource = customerList;
   
   // Attach the BindingSource to the DataGridView.
   this->customersDataGridView->DataSource =
      this->customersBindingSource;
}
private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Create and populate the list of DemoCustomer objects
    // which will supply data to the DataGridView.
    List<DemoCustomer> customerList = new List<DemoCustomer>();
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());

    // Bind the list to the BindingSource.
    this.customersBindingSource.DataSource = customerList;

    
    // Attach the BindingSource to the DataGridView.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}
Private Sub Form1_Load(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Me.Load
    ' Create and populate the list of DemoCustomer objects
    ' which will supply data to the DataGridView.
    Dim customerList As List(Of DemoCustomer) = _
    New List(Of DemoCustomer)
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())

    ' Bind the list to the BindingSource.
    Me.customersBindingSource.DataSource = customerList

    ' Attach the BindingSource to the DataGridView.
    Me.customersDataGridView.DataSource = Me.customersBindingSource
End Sub

Remarques

La DataSource propriété peut être définie sur plusieurs sources de données, y compris les types, les objets et les listes de types.The DataSource property can be set to a number of data sources, including types, objects, and lists of types. La source de données résultante sera exposée sous la forme d’une liste.The resulting data source will be exposed as a list. Le tableau suivant présente certaines des sources de données communes et l’évaluation de la liste résultante.The following table shows some of the common data sources and the resulting list evaluation.

DataSource, propriétéDataSource property Liste des résultatsList results
null Vide IBindingList d’objets.An empty IBindingList of objects. L’ajout d’un élément affecte à la liste le type de l’élément ajouté.Adding an item sets the list to the type of the added item.
nullavec DataMember Setnull with DataMember set Non pris en charge ArgumentException, déclenche.Not supported, raises ArgumentException.
Type sans liste ou objet de type "T"Non-list type or object of type "T" Vide IBindingList de type "T".Empty IBindingList of type "T".
Instance de tableauArray instance IBindingListcontenant les éléments du tableau.IBindingList containing the array elements.
Instance IEnumerableIEnumerable instance IBindingList Contenant lesIEnumerable éléments.An IBindingList containing the IEnumerable items.
Instance List contenant le type "T"List instance containing type "T" IBindingListinstance contenant le type "T".IBindingList instance containing type "T".

En outre, DataSource peut être défini sur d’autres types de listes IListSource tels ITypedList que et BindingSource et le gère correctement.In addition, DataSource can be set to other list types such as IListSource and ITypedList and the BindingSource will handle them appropriately. Dans ce cas, le type contenu dans la liste doit avoir un constructeur sans paramètre.In this case, the type contained in the list should have a parameterless constructor.

Lors de la définition d’une source de données, si la référence fournie contient plusieurs listes ou tables, vous devez DataMember affecter à la propriété une chaîne qui spécifie la liste à laquelle effectuer la liaison.When setting a data source, if the supplied reference contains more than one list or table, you must set the DataMember property to a string that specifies the list to bind to. La définition de cette propriété DataSourceChanged déclenche l’événement.Setting this property raises the DataSourceChanged event.

Notes

Si vous apportez des modifications à la DataSource valeur de propriété, vous devez le faire sur le thread d’interface utilisateur pour vous assurer que l’interface utilisateur reflète les modifications.If you make any changes to the DataSource property value, you should do so on the user interface (UI) thread to ensure that the UI reflects the changes.

La DataSource propriété est la propriété par défaut de BindingSource la classe.The DataSource property is the default property for the BindingSource class.

S’applique à

Voir aussi