BindingSource.DataSource Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur sumber data yang diikat konektor.

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

Nilai Properti

Object

Yang Object bertindak sebagai sumber data. Default adalah null.

Contoh

Contoh kode berikut menetapkan daftar pelanggan ke DataSourceBindingSource komponen. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan di Cara: Menaikkan Pemberitahuan Perubahan Menggunakan Metode ResetItem BindingSource.

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

Keterangan

DataSource Properti dapat diatur ke sejumlah sumber data, termasuk jenis, objek, dan daftar jenis. Sumber data yang dihasilkan akan diekspos sebagai daftar. Tabel berikut ini memperlihatkan beberapa sumber data umum dan evaluasi daftar yang dihasilkan.

Properti DataSource	Mencantumkan hasil
null	IBindingList Kosong dari objek. Menambahkan item akan mengatur daftar ke tipe item yang ditambahkan.
null dengan DataMember set	Tidak didukung, menaikkan ArgumentException.
Jenis non-daftar atau objek jenis "T"	Kosong IBindingList dari jenis "T".
Instans array	IBindingList berisi elemen array.
IEnumerable Sebagai contoh	IEnumerable Berisi IBindingList item.
Mencantumkan instans yang berisi jenis "T"	IBindingList instans yang berisi jenis "T".

Selain itu, DataSource dapat diatur ke jenis daftar lain seperti IListSource dan ITypedList dan BindingSource akan menanganinya dengan tepat. Dalam hal ini, jenis yang terkandung dalam daftar harus memiliki konstruktor tanpa parameter.

Saat mengatur sumber data, jika referensi yang disediakan berisi lebih dari satu daftar atau tabel, Anda harus mengatur DataMember properti ke string yang menentukan daftar yang akan diikat. Mengatur properti ini akan meningkatkan DataSourceChanged peristiwa.

Catatan

Jika Anda membuat perubahan pada DataSource nilai properti, Anda harus melakukannya pada utas antarmuka pengguna (UI) untuk memastikan bahwa UI mencerminkan perubahan.

Properti DataSource adalah properti default untuk BindingSource kelas .

Lihat juga

• DataMember
• IList
• IListSource