BindingSource.DataSource Propriété

Définition

Obtient ou définit la source de données à laquelle le connecteur effectue une liaison.

public:
 property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
public object DataSource { get; set; }
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. La valeur par défaut est null.

Exemples

L’exemple de code suivant affecte une liste de clients au d’un DataSourceBindingSource composant. 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 des types, des objets et des listes de types. La source de données résultante est exposée sous forme de liste. Le tableau suivant présente certaines des sources de données courantes et l’évaluation de la liste qui en résulte.

Propriété DataSource Lister les résultats
null Vide IBindingList d’objets. L’ajout d’un élément définit la liste sur le type de l’élément ajouté.
null avec DataMember set Non pris en charge, déclenche ArgumentException.
Type ou objet non list de type « T » Vide IBindingList de type « T ».
Tableau instance IBindingList contenant les éléments du tableau.
Instance IEnumerable IBindingList contenant les IEnumerable éléments.
Liste instance contenant le type « T » IBindingListinstance contenant le type « T ».

En outre, DataSource peut être défini sur d’autres types de liste tels que IListSource et ITypedList et les BindingSource gérera 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 .

Notes

Si vous apportez des modifications à la valeur de la DataSource 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 .

S’applique à

Voir aussi