Esporta (0) Stampa
Espandi tutto

Proprietà BindingSource.DataSource

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene o imposta l'origine dati a cui il connettore è associato.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in 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)

Valore proprietà

Object che funge da origine dati. Il valore predefinito è riferimento null (Nothing in Visual Basic).

È possibile impostare la proprietà DataSource su diverse origini dati, inclusi tipi, oggetti ed elenchi di tipi. L'origine dati risultante verrà esposta come elenco. Nella tabella riportata di seguito sono illustrate alcune delle origini dati comuni e la valutazione dell'elenco risultante.

Proprietà DataSource

Elenco risultante

riferimento null (Nothing in Visual Basic)

Un IBindingList di oggetti vuoto. L'aggiunta di un elemento imposta l'elenco sul tipo dell'elemento aggiunto.

riferimento null (Nothing in Visual Basic) con la proprietà DataMember impostata

Non supportata, genera ArgumentException.

Tipo diverso da elenco (non-list) oppure oggetto di tipo "T"

Oggetto IBindingList vuoto di tipo "T".

Istanza di matrice

Oggetto IBindingList contenente gli elementi della matrice.

Istanza dell'oggetto IEnumerable

Oggetto IBindingList contenente gli elementi dell'oggetto IEnumerable.

Istanza di elenco contenente il tipo "T"

Istanza dell'oggetto IBindingList contenente il tipo "T".

La proprietà DataSource può essere impostata anche su altri tipi di elenco, ad esempio IListSource e ITypedList, che verranno gestiti in modo appropriato da BindingSource. In questo caso, è necessario che il tipo contenuto nell'elenco disponga di un costruttore predefinito.

Quando si imposta un'origine dati, se il riferimento fornito contiene più di un elenco o tabella, è necessario impostare la proprietà DataMember su una stringa che specifichi l'elenco con cui eseguire l'associazione. L'impostazione di questa proprietà determina la generazione dell'evento DataSourceChanged.

La proprietà DataSource è la proprietà predefinita della classe BindingSource.

Nell'esempio di codice riportato di seguito viene assegnato un elenco di clienti alla proprietà DataSource di un componente BindingSource. Questo esempio di codice fa parte di un esempio più esaustivo fornito per Procedura: generare notifiche di modifica utilizzando il metodo ResetItem di 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 per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0

.NET Compact Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft