BindingSource.DataSource Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

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 DataSource BindingSource 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 .

Berlaku untuk

Bagikan melalui