BindingSource.DataSource Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

BindingSource.cs

Obtient ou définit la source de données à laquelle le connecteur est lié.

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 Object agit en tant que source de données. La valeur par défaut est null.

Exemples

L’exemple de code suivant affecte une liste de clients à l’un DataSourceBindingSource des composants. Cet exemple de code fait partie d’un exemple plus large fourni dans 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 un certain nombre de sources de données, notamment les types, les objets et les listes de types. La source de données résultante sera exposée sous forme de liste. Le tableau suivant présente certaines des sources de données courantes et l’évaluation de liste résultante.

DataSource, propriété	Résultats de la liste
null	IBindingList Vide d’objets. L’ajout d’un élément définit la liste au type de l’élément ajouté.
null avec DataMember set	Non pris en charge, déclenche ArgumentException.
Type non list ou objet de type « T »	Vide IBindingList de type « T ».
Instance de tableau	IBindingList contenant les éléments de tableau.
IEnumerable Exemple	Contenant IBindingList les IEnumerable éléments.
Instance de liste contenant le type « T »	IBindingList instance contenant le type « T ».

En outre, DataSource vous pouvez définir sur d’autres types de liste tels que IListSource et ITypedList les BindingSource gérer de manière appropriée. Dans ce cas, le type contenu dans la liste doit avoir un constructeur sans paramètre.

Lorsque vous définissez une source de données, si la référence fournie contient plusieurs listes ou tables, vous devez définir la DataMember propriété sur une chaîne qui spécifie la liste à lier. La définition de cette propriété déclenche l’événement DataSourceChanged .

Note

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.

La DataSource propriété est la propriété par défaut de la BindingSource classe.

Voir aussi

• DataMember
• IList
• IListSource