Binding Konstruktor
Definisi
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String)Parameter
- propertyName
- String
Nama properti kontrol yang akan diikat.
- dataMember
- String
Properti atau daftar yang akan diikat.
Pengecualian
propertyName bukan properti kontrol yang valid atau string kosong ("").
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:
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:
Peristiwa bernama PropertyName
Changed(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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)Parameter
- propertyName
- String
Nama properti kontrol yang akan diikat.
- dataMember
- String
Properti atau daftar yang akan diikat.
- formattingEnabled
- Boolean
true untuk memformat data yang ditampilkan; jika tidak, false.
Pengecualian
Properti yang diberikan oleh propertyName tidak ada pada kontrol.
-atau-
Properti yang diberikan adalah properti baca-saja.
Pemformatan dinonaktifkan dan propertyName bukan properti kontrol yang valid atau string kosong ("").
Berlaku untuk
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.
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.BindingPublic 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.
- 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
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:
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:
Peristiwa bernama PropertyName
Changed(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.BindingPublic 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.
- 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
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:
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:
Peristiwa bernama PropertyName
Changed(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.BindingPublic 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.
- 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
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:
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:
Peristiwa bernama PropertyName
Changed(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.BindingPublic 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.
- 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
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:
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:
Peristiwa bernama PropertyName
Changed(misalnya, Control.BackColorChanged)
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk