Cette documentation est archivée et n’est pas conservée.

BindingSource.DataSource, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

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

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public Object DataSource { get; set; }
/** @property */
public Object get_DataSource ()

/** @property */
public void set_DataSource (Object value)

public function get DataSource () : Object

public function set DataSource (value : Object)

Valeur de la propriété

Object qui agit comme une source de données. La valeur par défaut est référence Null (Nothing en Visual Basic).

La propriété DataSource peut avoir pour valeur plusieurs sources de données, y compris des types, des objets et des listes de types. La source de données obtenue sera exposée comme une liste. Le tableau suivant illustre quelques sources de donnée courantes et l'évaluation de liste résultante.

Propriété DataSource

Résultats de la liste

référence Null (Nothing en Visual Basic)

IBindingList vide d'objets. L'ajout d'un élément affecte à la liste la valeur du type de l'élément ajouté.

référence Null (Nothing en Visual Basic) avec DataMember défini.

Non pris en charge, déclenche ArgumentException.

Type n'appartenant pas à une liste ou objet de type "T"

IBindingList vide de type "T".

Instance de tableau

IBindingList contenant les éléments du tableau.

Instance de IEnumerable

IBindingList contenant les éléments IEnumerable.

Instance de liste contenant le type "T"

Instance de IBindingList contenant le type "T".

En outre, DataSource peut avoir pour valeur d'autres types de listes, tels que IListSource et ITypedList, et BindingSource les gérera correctement. Dans ce cas, le type contenu dans la liste doit avoir un constructeur par défaut.

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

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

L'exemple de code suivant assigne une liste de clients au DataSource d'un composant BindingSource. Cet exemple de code fait partie d'un exemple plus développé fourni à Comment : générer des notifications de modifications à l'aide de la méthode ResetItem de BindingSource.

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;
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

.NET Compact Framework

Prise en charge dans : 2.0
Afficher: