BindingSource.DataSource Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 .