Binding Konstruktor

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.

Menginisialisasi instans baru kelas Binding.

Overload

Binding(String, Object, String)	Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data sumber data yang ditentukan.
Binding(String, Object, String, Boolean)	Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data sumber data yang ditentukan, dan secara opsional memungkinkan pemformatan diterapkan.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan dan menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, dan mengatur properti ke nilai yang DBNull ditentukan saat dikembalikan dari sumber data.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan dengan string format yang ditentukan; menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan; dan mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Menginisialisasi instans Binding baru kelas dengan properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan dengan string format yang ditentukan; menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan; mengaktifkan pemformatan dengan string format yang ditentukan; mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data; dan mengatur penyedia format yang ditentukan.

Binding(String, Object, String)

Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data sumber data yang ditentukan.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);

public Binding (string propertyName, object dataSource, string dataMember);

public Binding (string propertyName, object? dataSource, string? dataMember);

new System.Windows.Forms.Binding : string * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

Pengecualian

Exception

propertyName bukan properti kontrol yang valid atau string kosong ("").

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

Contoh

Contoh kode berikut mengikat TextBox kontrol ke kolom tabel di bernama DataSetmyDataSet. Contoh ini mengharuskan myDataSet Anda telah mendeklarasikan di bagian deklarasi modul.

private:
   void CreateDataSet()
   {
      myDataSet = gcnew DataSet( "myDataSet" );
      /* Populates the DataSet with tables, relations, and 
         constraints. */
   }

   void BindTextBoxToDataSet()
   {
      /* Binds a TextBox control to a DataColumn named
      CompanyName in the DataTable named Suppliers. */
      textBox1->DataBindings->Add(
         "Text", myDataSet, "Suppliers.CompanyName" );
   }

private void CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

private void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   ("Text", myDataSet, "Suppliers.CompanyName");
}

Private Sub CreateDataSet
   myDataSet = new DataSet("myDataSet")
   ' Populates the DataSet with tables, relations, and
   ' constraints.
End Sub

Private Sub BindTextBoxToDataSet 
   ' Binds a TextBox control to a column in the DataSet.
   textBox1.DataBindings.Add _
   ("Text", myDataSet, "Suppliers.CompanyName")
End Sub

Keterangan

Anda dapat menentukan instans salah satu kelas berikut untuk sumber data:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Kelas apa pun yang mengimplementasikan IList antarmuka
Kelas apa pun

Binding Lihat kelas untuk informasi selengkapnya tentang membuat dataMember string.

Saat Anda membuat pengikatan ke properti kontrol, yang baru Binding memeriksa peristiwa yang diekspos oleh kontrol terikat dan melampirkan ke dua peristiwa tertentu:

Control.Validating
Peristiwa bernama PropertyNameChanged (misalnya, Control.BackColorChanged)

Jika Anda mencoba mengikat ke properti yang tidak ada, ArgumentException akan dilemparkan saat Binding ditambahkan ke koleksi kontrol Control.DataBindings .

Lihat juga

Berlaku untuk

Binding(String, Object, String, Boolean)

Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data sumber data yang ditentukan, dan secara opsional memungkinkan pemformatan diterapkan.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled);

new System.Windows.Forms.Binding : string * obj * string * bool -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Properti yang diberikan adalah properti baca-saja.

Exception

Pemformatan dinonaktifkan dan propertyName bukan properti kontrol yang valid atau string kosong ("").

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode);

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

dataSourceUpdateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Sumber data atau anggota data atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Anda dapat menentukan instans salah satu kelas berikut untuk sumber data:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Kelas apa pun yang mengimplementasikan IList antarmuka
Kelas apa pun

Binding Lihat kelas untuk informasi selengkapnya tentang membuat dataMember string.

Saat Anda membuat pengikatan ke properti kontrol, yang baru Binding memeriksa peristiwa yang diekspos oleh kontrol terikat dan melampirkan ke dua peristiwa tertentu:

Control.Validating.
Peristiwa bernama PropertyNameChanged (misalnya, Control.BackColorChanged)

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditunjukkan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan, menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan, dan mengatur properti ke nilai yang DBNull ditentukan saat dikembalikan dari sumber data.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue);

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

dataSourceUpdateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

yang Object akan diterapkan ke properti kontrol terikat jika nilai sumber data adalah DBNull.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Sumber data atau anggota data atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Anda dapat menentukan instans salah satu kelas berikut untuk sumber data:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Kelas apa pun yang mengimplementasikan IList antarmuka
Kelas apa pun

Binding Lihat kelas untuk informasi selengkapnya tentang membuat dataMember string.

Saat Anda membuat pengikatan ke properti kontrol, yang baru Binding memeriksa peristiwa yang diekspos oleh kontrol terikat dan melampirkan ke dua peristiwa tertentu:

Control.Validating
Peristiwa bernama PropertyNameChanged (misalnya, Control.BackColorChanged)

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Menginisialisasi instans Binding baru kelas yang mengikat properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan dengan string format yang ditentukan; menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan; dan mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString);

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

dataSourceUpdateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

yang Object akan diterapkan ke properti kontrol terikat jika nilai sumber data adalah DBNull.

formatString: String

Satu atau beberapa karakter penentu format yang menunjukkan bagaimana nilai akan ditampilkan.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Sumber data atau anggota data atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Anda dapat menentukan instans salah satu kelas berikut untuk sumber data:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Kelas apa pun yang mengimplementasikan IList antarmuka
Kelas apa pun

Binding Lihat kelas untuk informasi selengkapnya tentang membuat dataMember string.

Saat Anda membuat pengikatan ke properti kontrol, yang baru Binding memeriksa peristiwa yang diekspos oleh kontrol terikat dan melampirkan ke dua peristiwa tertentu:

Control.Validating
Peristiwa bernama PropertyNameChanged (misalnya, Control.BackColorChanged)

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Menginisialisasi instans Binding baru kelas dengan properti kontrol yang ditentukan ke anggota data yang ditentukan dari sumber data yang ditentukan. Secara opsional mengaktifkan pemformatan dengan string format yang ditentukan; menyebarkan nilai ke sumber data berdasarkan pengaturan pembaruan yang ditentukan; mengaktifkan pemformatan dengan string format yang ditentukan; mengatur properti ke nilai yang ditentukan saat DBNull dikembalikan dari sumber data; dan mengatur penyedia format yang ditentukan.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString, IFormatProvider formatInfo);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider)

Parameter

propertyName: String

Nama properti kontrol yang akan diikat.

dataSource: Object

Yang Object mewakili sumber data.

dataMember: String

Properti atau daftar yang akan diikat.

formattingEnabled: Boolean

true untuk memformat data yang ditampilkan; jika tidak, false.

dataSourceUpdateMode: DataSourceUpdateMode

Salah DataSourceUpdateMode satu nilai.

nullValue: Object

yang Object akan diterapkan ke properti kontrol terikat jika nilai sumber data adalah DBNull.

formatString: String

Satu atau beberapa karakter penentu format yang menunjukkan bagaimana nilai akan ditampilkan.

formatInfo: IFormatProvider

Implementasi IFormatProvider untuk mengambil alih perilaku pemformatan default.

Pengecualian

ArgumentException

Properti yang diberikan oleh propertyName tidak ada pada kontrol.

-atau-

Sumber data atau anggota data atau properti kontrol yang ditentukan dikaitkan dengan pengikatan lain dalam koleksi.

Keterangan

Anda dapat menentukan instans salah satu kelas berikut untuk sumber data:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Kelas apa pun yang mengimplementasikan IList antarmuka
Kelas apa pun

Binding Lihat kelas untuk informasi selengkapnya tentang membuat dataMember string.

Saat Anda membuat pengikatan ke properti kontrol, yang baru Binding memeriksa peristiwa yang diekspos oleh kontrol terikat dan melampirkan ke dua peristiwa tertentu:

Control.Validating
Peristiwa bernama PropertyNameChanged (misalnya, Control.BackColorChanged)

Berlaku untuk

Bagikan melalui

Binding Konstruktor

Definisi

Overload

Binding(String, Object, String)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Binding(String, Object, String, Boolean)

Parameter

Pengecualian

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Parameter

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: